SafeHandle.SetHandleAsInvalid Метод

Определение

Пространство имен:
System.Runtime.InteropServices
Сборки:
mscorlib.dll, System.Runtime.Handles.dll
Сборка:
System.Runtime.dll
Сборка:
System.Runtime.Handles.dll
Сборка:
mscorlib.dll
Сборка:
System.Runtime.InteropServices.dll
Сборка:
Сборка:
netstandard.dll

Помечает дескриптор как больше не используемый.Marks a handle as no longer used.

public:
 void SetHandleAsInvalid();
public void SetHandleAsInvalid ();
[System.Security.SecurityCritical]
public void SetHandleAsInvalid ();
member this.SetHandleAsInvalid : unit -> unit
[<System.Security.SecurityCritical>]
member this.SetHandleAsInvalid : unit -> unit
Public Sub SetHandleAsInvalid ()
Атрибуты
SecurityCriticalAttribute

Комментарии

Вызовите 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.

Применяется к