SafeHandle.DangerousAddRef(Boolean) Methode

Definition

Namespace:

System.Runtime.InteropServices

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

SafeHandle.cs

Erhöht den Verweiszähler manuell auf 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

truewenn der Referenzzähler erfolgreich erhöht wurde; andernfalls . false

Ausnahmen

ObjectDisposedException

Das SafeHandle wurde gelöscht.

Hinweise

Die DangerousAddRef Methode verhindert, dass die Common Language Runtime den von einem Handle verwendeten Arbeitsspeicher zurückgibt (was auftritt, wenn die Laufzeit 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 mit einem ref Parameter (success) zurück, der angibt, ob die Verweisanzahl erfolgreich erhöht wurde. Auf diese Weise kann die Programmlogik im Falle eines Fehlers wieder ausgeblendet werden. Sie sollten vor dem Aufrufen successauf falseDangerousAddRef Wenn success ja true, vermeiden Sie Ressourcenlecks, indem Sie den Anruf DangerousAddRef mit einem entsprechenden Aufruf abgleichen DangerousRelease.

Wenn dieser Aufruf erfolgreich ist, legt er den ref bool success Parameter true auf und gibt ihn erfolgreich zurück. Wenn dieser Aufruf nicht erfolgreich ist, löst er eine Ausnahme aus und belässt den ref bool success Parameter unverändert.

Weitere Informationen

• DangerousRelease()