SafeHandle.DangerousAddRef(Boolean) Metodo

Definizione

Incrementa manualmente il numero di riferimenti nelle istanze di 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)

Parametri

success
Boolean

true se il numero di riferimenti è stato incrementato correttamente; in caso contrario, false.true if the reference counter was successfully incremented; otherwise, false.

Attributi

Commenti

Il metodo DangerousAddRef impedisce al Common Language Runtime di recuperare la memoria usata da un handle (che si verifica quando il runtime chiama il metodo 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). È possibile utilizzare questo metodo per incrementare manualmente il conteggio dei riferimenti in un'istanza di SafeHandle.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRef restituisce un valore booleano usando un parametro di ref (success) che indica se il conteggio dei riferimenti è stato incrementato correttamente.DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. In questo modo è possibile eseguire il backup della logica del programma in caso di errore.This allows your program logic to back out in case of failure. Prima di chiamare DangerousAddRef, è necessario impostare success su false.You should set success to false before calling DangerousAddRef. Se success è true, evitare perdite di risorse associando la chiamata a DangerousAddRef con una chiamata corrispondente a DangerousRelease.If success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

Attenzione

Questo metodo è destinato agli utenti avanzati ed è necessario utilizzarlo sempre con attenzione.This method is intended for advanced users and must always be used carefully. Per evitare la perdita di risorse di gestione, chiamare sempre questo metodo all'interno di un'area a esecuzione vincolata (CER), in cui l'interruzione di un thread non può interrompere l'elaborazione.To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

Sicurezza

SecurityPermission
per l'autorizzazione a chiamare codice non gestito.for permission to call unmanaged code. Azione di sicurezza: LinkDemand.Security action: LinkDemand. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

Si applica a

Vedi anche