SafeHandle.SetHandleAsInvalid メソッド

定義

今後は使用しないものとしてハンドルをマークします。Marks a handle as no longer used.

public:
 void SetHandleAsInvalid();
[System.Security.SecurityCritical]
public void SetHandleAsInvalid ();
public void SetHandleAsInvalid ();
member this.SetHandleAsInvalid : unit -> unit
Public Sub SetHandleAsInvalid ()
属性

注釈

ハンドルがリソースを参照しなくなったことがわかっている場合にのみ、SetHandleAsInvalid メソッドを呼び出します。Call the SetHandleAsInvalid method only when you know that your handle no longer references a resource. この操作を行っても、handle フィールドの値は変更されません。ハンドルを closed としてマークするだけです。Doing so does not change the value of the handle field; it only marks the handle as closed. このハンドルには、古くなった可能性のある値が含まれている可能性があります。The handle might then contain a potentially stale value. この呼び出しの結果として、リソースの解放は行われません。The effect of this call is that no attempt is made to free the resources.

SetHandle メソッドと同様に、既存のハンドルをサポートする必要がある場合にのみ、SetHandleAsInvalid を使用します。As with the SetHandle method, use SetHandleAsInvalid only if you need to support a pre-existing handle.

適用対象