SafeHandle.DangerousAddRef(Boolean) Methode

Definition

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

Ausnahmen

Der SafeHandle wurde verworfen.

Hinweise

Die DangerousAddRef -Methode verhindert, dass die Common Language Runtime Arbeitsspeicher zurückgibt, der von einem Handle verwendet wird (was auftritt, wenn die Runtime die ReleaseHandle -Methode aufruft). Sie können diese Methode verwenden, um die Verweisanzahl für eine SafeHandle Instanz manuell zu erhöhen. DangerousAddRef gibt einen booleschen Wert mithilfe eines ref Parameters (success) zurück, der angibt, ob die Verweisanzahl erfolgreich erhöht wurde. Dies ermöglicht es Ihrer Programmlogik, im Falle eines Fehlers einen Rückschlag zu machen. Sie sollten auf festlegen success , false bevor Sie aufrufen DangerousAddRef. Wenn success ist true, vermeiden Sie Ressourcenverluste, indem Sie den Aufruf von DangerousAddRef mit einem entsprechenden Aufruf von DangerousReleaseabgleichen.

Wenn dieser Aufruf erfolgreich ist, wird der ref bool success Parameter auf true festgelegt und erfolgreich zurückgegeben. Wenn dieser Aufruf nicht erfolgreich ist, wird eine Ausnahme ausgelöst, und der ref bool success Parameter bleibt unverändert.

Gilt für:

Weitere Informationen