SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) Method

Definition

Inkrementiert manuell den Verweiszähler für SafeHandle-Instanzen.Manually increments the reference counter on SafeHandle instances.

public:
 void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

Parameter

success
Boolean Boolean Boolean Boolean

true, wenn der Verweiszähler erfolgreich inkrementiert wurde, andernfalls false.true if the reference counter was successfully incremented; otherwise, false.

Hinweise

Die DangerousAddRef -Methode verhindert, dass die Common Language Runtime von einem Handle verwendeter Speicher freigegeben wird (dieser tritt auf, ReleaseHandle wenn die Laufzeit die-Methode aufruft).The DangerousAddRef method prevents the common language runtime from reclaiming memory used by a handle (which occurs when the runtime calls the ReleaseHandle method). Sie können diese Methode verwenden, um den Verweis Zähler für eine SafeHandle -Instanz manuell zu erhöhen.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRefGibt einen booleschen Wert mithilfe eines ref Parameterssuccess() zurück, der angibt, ob der Verweis Zähler erfolgreich inkrementiert wurde.DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. Dies ermöglicht es ihrer Programmlogik, bei einem Fehler zurückzukehren.This allows your program logic to back out in case of failure. Legen Sie auf success fest false , bevor DangerousAddRefSie aufrufen.You should set success to false before calling DangerousAddRef. success DangerousAddRef Wenn den Wert DangerousReleasehat, vermeiden Sie Ressourcen Lecks, indem Sie den-Befehl mit einem entsprechenden-Befehl abgleichen. trueIf success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

Achtung

Diese Methode ist für fortgeschrittene Benutzer gedacht und muss immer sorgfältig verwendet werden.This method is intended for advanced users and must always be used carefully. Um das Verlust von handle-Ressourcen zu vermeiden, wird diese Methode immer in einem eingeschränkten Ausführungs Bereich (CER) aufgerufen, in dem ein Thread Abbruch die Verarbeitung nicht unterbrechen kann.To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

Sicherheit

SecurityPermission
für die Berechtigung zum Abrufen von nicht verwaltetem Code.for permission to call unmanaged code. Sicherheitsaktion: LinkDemand.Security action: LinkDemand. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für:

Siehe auch