SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) Method

定義

SafeHandle インスタンスの参照カウンターを手動でインクリメントします。Manually increments the reference counter on SafeHandle instances.

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

パラメーター

success
Boolean Boolean Boolean Boolean

参照カウンターが正常にインクリメントされた場合は true。それ以外の場合は falsetrue if the reference counter was successfully incremented; otherwise, false.

注釈

DangerousAddRefメソッドでは、共通言語ランタイムを防ぎますハンドルによって使用されるメモリを再利用 (ランタイムが呼び出す場合に発生する、ReleaseHandleメソッド)。The DangerousAddRef method prevents the common language runtime from reclaiming memory used by a handle (which occurs when the runtime calls the ReleaseHandle method). このメソッドの参照カウントを手動でインクリメントを使用することができます、SafeHandleインスタンス。You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRef 使用してブール値を返します、refパラメーター (success)、参照カウントが正常にインクリメントされたかどうかを示します。DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. これにより、障害発生時に、プログラム ロジックです。This allows your program logic to back out in case of failure. 設定する必要がありますsuccessfalse呼び出す前にDangerousAddRefします。You should set success to false before calling DangerousAddRef. 場合successtrueへの呼び出しを照合することによってリソースのリークを避けるためDangerousAddRefに対応する呼び出しでDangerousReleaseします。If success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

注意事項

このメソッドは、高度なユーザーのためのものでは、常に慎重に使用する必要があります。This method is intended for advanced users and must always be used carefully. ハンドル リソースのリークを避けるため、常に、スレッドの中止が処理を中断できない制約された実行領域 (CER) 内でこのメソッドを呼び出します。To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

セキュリティ

SecurityPermission
アンマネージ コードを呼び出すアクセス許可。for permission to call unmanaged code. セキュリティ アクション:LinkDemandします。Security action: LinkDemand. 関連付けられた列挙体。 UnmanagedCodeAssociated enumeration: UnmanagedCode

適用対象

こちらもご覧ください