SafeHandle.SetHandleAsInvalid Methode

Definition

Markiert ein Handle als nicht mehr verwendet.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 ()
Attribute

Hinweise

Ruft die SetHandleAsInvalid-Methode nur auf, wenn Sie wissen, dass Ihr Handle nicht mehr auf eine Ressource verweist.Call the SetHandleAsInvalid method only when you know that your handle no longer references a resource. Dadurch wird der Wert des handle Felds nicht geändert. das Handle wird nur als geschlossen markiert.Doing so does not change the value of the handle field; it only marks the handle as closed. Das Handle kann dann einen potenziell veralteten Wert enthalten.The handle might then contain a potentially stale value. Die Auswirkung dieses Aufrufens besteht darin, dass kein Versuch unternommen wird, die Ressourcen freizugeben.The effect of this call is that no attempt is made to free the resources.

Verwenden Sie wie bei der SetHandle-Methode nur SetHandleAsInvalid, wenn Sie ein bereits vorhandenes handle unterstützen müssen.As with the SetHandle method, use SetHandleAsInvalid only if you need to support a pre-existing handle.

Gilt für: