SafeHandle.DangerousAddRef(Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Inkrementiert manuell den Verweiszähler für SafeHandle-Instanzen.
public:
void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);
public void DangerousAddRef (ref bool success);
[<System.Security.SecurityCritical>]
member this.DangerousAddRef : bool -> unit
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
.
- Attribute
Hinweise
Die DangerousAddRef Methode verhindert, dass die allgemeine Sprachlaufzeit den von einem Handle verwendeten Speicher zurückgibt (was auftritt, wenn die Laufzeit die ReleaseHandle Methode aufruft). Sie können diese Methode verwenden, um die Referenzanzahl einer SafeHandle Instanz manuell zu erhöhen. DangerousAddRef gibt einen booleschen Wert mit einem ref
Parameter (success
) zurück, der angibt, ob die Referenzanzahl erfolgreich erhöht wurde. Dadurch kann ihre Programmlogik im Falle eines Fehlers zurückgespielt werden. Sie sollten vor dem Aufrufen DangerousAddRefauf "Festlegen" false
festgelegt success
sein. Wenn es success
true
sich handelt, vermeiden Sie Ressourcenlecks, indem Sie den Anruf mit einem entsprechenden Aufruf DangerousAddRef übereinstimmen DangerousRelease.
Achtung
Diese Methode ist für erweiterte Benutzer vorgesehen und muss immer sorgfältig verwendet werden. Um die Verleckung von Ressourcen zu vermeiden, rufen Sie diese Methode immer innerhalb eines eingeschränkten Ausführungsbereichs (CER) auf, bei dem eine Threadabbruchverarbeitung nicht unterbrochen werden kann.