SafeHandle.DangerousAddRef(Boolean) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt het referentiemeteritem SafeHandle voor exemplaren handmatig verhoogd.
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)Parameters
- success
- Boolean
true als het verwijzingsteller is verhoogd; anders, false.
- Kenmerken
Uitzonderingen
De SafeHandle is verwijderd.
Opmerkingen
Met DangerousAddRef de methode voorkomt u dat de algemene taalruntime geheugen vrijgeeft die door een ingang wordt gebruikt (wat gebeurt wanneer de runtime de ReleaseHandle methode aanroept). U kunt deze methode gebruiken om het aantal verwijzingen handmatig te verhogen op een SafeHandle exemplaar.
DangerousAddRef retourneert een Booleaanse waarde met behulp van een ref parameter (success) die aangeeft of het aantal verwijzingen is verhoogd. Hierdoor kan uw programmalogica een back-up maken in het geval van een fout. U moet dit instellen successfalse voordat u belt DangerousAddRef. Als success dat het is true, vermijdt u resourcelekken door de aanroep te koppelen aan DangerousAddRef een overeenkomstige aanroep naar DangerousRelease.
Als deze aanroep is geslaagd, wordt de ref bool success parameter true ingesteld op en geretourneerd. Als deze aanroep mislukt, wordt er een uitzondering gegenereerd en blijft de ref bool success parameter ongewijzigd.