SafeHandle.DangerousAddRef(Boolean) メソッド

定義

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

属性

例外

SafeHandle が破棄されました。

注釈

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

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

適用対象

こちらもご覧ください