SafeHandle.SetHandleAsInvalid Method

Definition

Помечает дескриптор как больше не используемый.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 ()
Attributes

Remarks

Вызовите метод SetHandleAsInvalid, только если известно, что ваш обработчик больше не ссылается на ресурс.Call the SetHandleAsInvalid method only when you know that your handle no longer references a resource. Это не изменяет значение поля handle. Он помечает только маркер как закрытый.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.

Applies to