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
Remarques
La DangerousAddRef méthode empêche le common language runtime de récupérer la mémoire utilisée par un handle (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 revenir en arrière en cas d’échec. Vous devez définir la valeur success avant d’appeler false DangerousAddRef. Si success c’est truele cas, évitez les fuites de ressources en correspondant à l’appel avec DangerousAddRef un appel correspondant à DangerousRelease.
Attention
Cette méthode est destinée aux utilisateurs avancés et doit toujours être utilisée avec soin. Pour éviter les fuites de ressources de handle, appelez toujours cette méthode à l’intérieur d’une région d’exécution contrainte (CER), où une interruption de thread ne peut pas interrompre le traitement.