System.Runtime.InteropServices.SafeHandle.SetHandleAsInvalid Method

Marks a handle as no longer used.

Syntax

[System.Runtime.ConstrainedExecution.ReliabilityContract(System.Runtime.ConstrainedExecution.Consistency.WillNotCorruptState, System.Runtime.ConstrainedExecution.Cer.Success)]
public void SetHandleAsInvalid ()

Remarks

Call the SafeHandle.SetHandleAsInvalid method only when you know that your handle no longer references a resource. Doing so does not change the value of the SafeHandle.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.

As with the SafeHandle.SetHandle(IntPtr) method, use SafeHandle.SetHandleAsInvalid only if you need to support a pre-existing handle.

Requirements

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: