SafeHandle.DangerousAddRef(Boolean) Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Source:

SafeHandle.cs

Incrémente manuellement le compteur de références sur les instances de SafeHandle.

public:
 void DangerousAddRef(bool % success);

public void DangerousAddRef (ref bool success);

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.

Exceptions

ObjectDisposedException

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 un 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é.

Voir aussi

• DangerousRelease()