SafeHandle.DangerousAddRef(Boolean) メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.dll

ソース:

SafeHandle.cs

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

public:
 void DangerousAddRef(bool % success);

public void DangerousAddRef (ref bool success);

member this.DangerousAddRef : bool -> unit

Public Sub DangerousAddRef (ByRef success As Boolean)

パラメーター

success

Boolean

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

例外

ObjectDisposedException

SafeHandle が破棄されました。

注釈

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

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

こちらもご覧ください

• DangerousRelease()