SafeHandle.DangerousAddRef(Boolean) Méthode

Définition

Incrémente manuellement le compteur de références sur les instances de SafeHandle.Manually increments the reference counter on SafeHandle instances.

public:
 void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
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.true if the reference counter was successfully incremented; otherwise, false.

Attributs

Remarques

La méthode DangerousAddRef empêche le common language runtime de libérer de la mémoire utilisée par un handle (qui se produit lorsque le runtime appelle la méthode ReleaseHandle).The DangerousAddRef method prevents the common language runtime from reclaiming memory used by a handle (which occurs when the runtime calls the ReleaseHandle method). Vous pouvez utiliser cette méthode pour incrémenter manuellement le décompte de références sur une instance de SafeHandle.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRef retourne une valeur booléenne à l’aide d’un paramètre ref (success) qui indique si le décompte de références a été incrémenté avec succès.DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. Cela permet à votre logique de programme de revenir en cas d’échec.This allows your program logic to back out in case of failure. Vous devez définir success sur false avant d’appeler DangerousAddRef.You should set success to false before calling DangerousAddRef. Si success est true, évitez les fuites de ressources en faisant correspondre l’appel à DangerousAddRef avec un appel correspondant à DangerousRelease.If success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

Attention

Cette méthode est destinée aux utilisateurs expérimentés et doit toujours être utilisée avec précaution.This method is intended for advanced users and must always be used carefully. Pour éviter toute fuite de ressources de gestion, appelez toujours cette méthode à l’intérieur d’une région d’exécution limitée, où l’abandon d’un thread ne peut pas interrompre le traitement.To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

Sécurité

SecurityPermission
pour obtenir l’autorisation d’appeler du code non managé.for permission to call unmanaged code. Action de sécurité : LinkDemand.Security action: LinkDemand. Énumération associée : UnmanagedCodeAssociated enumeration: UnmanagedCode

S’applique à

Voir aussi