Partager via


SafeHandle.DangerousAddRef(Boolean) Méthode

Définition

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 -> unit
member this.DangerousAddRef : bool -> unit
Public 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é.

S’applique à

Voir aussi