SafeHandle.DangerousAddRef(Boolean) メソッド

定義

名前空間:
System.Runtime.InteropServices
アセンブリ:
mscorlib.dll, System.Runtime.Handles.dll
アセンブリ:
mscorlib.dll
アセンブリ:
System.Runtime.InteropServices.dll
アセンブリ:
System.Runtime.Handles.dll
アセンブリ:
netstandard.dll

SafeHandleインスタンスの参照カウンターを手動でインクリメントします。

public:
 void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef(ref bool success);
public void DangerousAddRef(ref bool success);
[<System.Security.SecurityCritical>]
member this.DangerousAddRef : bool -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

パラメーター

success
Boolean

true 参照カウンターが正常にインクリメントされた場合。それ以外の場合は false。

属性
SecurityCriticalAttribute

例外

ObjectDisposedException

SafeHandle が破棄されました。

注釈

DangerousAddRef メソッドは、共通言語ランタイムがハンドルによって使用されるメモリを再利用できないようにします (ランタイムが ReleaseHandle メソッドを呼び出すときに発生します)。 このメソッドを使用すると、 SafeHandle インスタンスの参照カウントを手動でインクリメントできます。 DangerousAddRef は、参照カウントが正常にインクリメントされたかどうかを示す ref パラメーター (success) を使用してブール値を返します。 これにより、障害が発生した場合にプログラム ロジックをバックアウトできます。 DangerousAddRefを呼び出す前に、successを false に設定する必要があります。 successがtrueされている場合は、DangerousAddRefの呼び出しと対応するDangerousReleaseの呼び出しを照合することで、リソース リークを回避します。

この呼び出しが成功すると、 ref bool success パラメーターが true に設定され、正常に返されます。 この呼び出しが失敗した場合、例外がスローされ、 ref bool success パラメーターは変更されません。

適用対象

こちらもご覧ください