SafeHandle.DangerousAddRef(Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Incrémente manuellement le compteur de références sur les instances de SafeHandle.
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)Paramètres
- success
- Boolean
true si l'incrémentation du compteur de références a réussi ; sinon, false.
- Attributs
Exceptions
Le SafeHandle a été supprimé.
Remarques
La DangerousAddRef méthode empêche le Common Language Runtime de récupérer la mémoire utilisée par un handle (ce qui se produit lorsque le runtime appelle la ReleaseHandle méthode ). Vous pouvez utiliser cette méthode pour incrémenter manuellement le nombre de références sur une SafeHandle instance.
DangerousAddRef retourne une valeur booléenne à l’aide d’un ref paramètre (success) qui indique si le nombre de références a été incrémenté avec succès. Cela permet à votre logique de programme de reculer en cas de défaillance. Vous devez définir sur successfalse avant d’appeler DangerousAddRef. Si success a la valeur true, évitez les fuites de ressources en faisant correspondre l’appel à DangerousAddRef avec un appel correspondant à DangerousRelease.
Si cet appel réussit, il définit le ref bool success paramètre sur true et retourne correctement. Si cet appel échoue, il lève une exception et laisse le ref bool success paramètre inchangé.
