SafeHandle.DangerousAddRef(Boolean) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
。
- 属性
注釈
このメソッドは DangerousAddRef 、共通言語ランタイムがハンドルによって使用されるメモリを再利用できないようにします (これは、ランタイムがメソッドを呼び出すときに ReleaseHandle 発生します)。 このメソッドを使用して、インスタンスの参照カウントを手動で SafeHandle インクリメントできます。 DangerousAddRefは、参照カウントが正常にインクリメントされたかどうかを示すパラメーター (success
) を使用してref
ブール値を返します。 これにより、エラーが発生した場合にプログラム ロジックをバックアウトできます。 呼び出すDangerousAddRef前に設定success
するfalse
必要があります。 の場合 success
は true
、呼び出しと対応する呼び出し DangerousAddRef を照合して、リソース リークを回避します DangerousRelease。
注意事項
この方法は上級ユーザーを対象としており、常に慎重に使用する必要があります。 ハンドル リソースのリークを回避するには、スレッドの中止が処理を中断できない、制約付き実行領域内 (CER) 内で常にこのメソッドを呼び出します。