SafeHandle.DangerousAddRef(Boolean) Methode

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);
public void DangerousAddRef (ref bool success);
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

Parameter

success
Boolean

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

Attribute

Hinweise

Die DangerousAddRef-Methode verhindert, dass die Common Language Runtime von einem Handle verwendeter Arbeitsspeicher freigegeben wird (dieser tritt auf, wenn die Common Language Runtime die ReleaseHandle-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. DangerousAddRef gibt einen booleschen Wert zurück, indem ein ref Parameter (success) verwendet wird, 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. Vor dem Aufrufen von DangerousAddRefsollten Sie success auf false festlegen.You should set success to false before calling DangerousAddRef. Wenn success trueist, vermeiden Sie Ressourcen Lecks, indem Sie den-AufrufDangerousAddRef mit einem entsprechenden-DangerousReleaseaufzurufen.If 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.

Gilt für:

Siehe auch