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 -> unitmember this.DangerousAddRef : bool -> unitPublic 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.
