SafeHandle.DangerousAddRef(Boolean) Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Quelle:

SafeHandle.cs

Inkrementiert manuell den Verweiszähler für SafeHandle-Instanzen.

public:
 void DangerousAddRef(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.

Ausnahmen

ObjectDisposedException

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 auf einem SafeHandle instance 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.

Weitere Informationen

• DangerousRelease()