SafeHandle.DangerousAddRef(Boolean) Metodo

Definizione

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

Parametri

success
Boolean

true se il numero di riferimenti è stato incrementato correttamente; in caso contrario, false.

Attributi

Commenti

Il metodo impedisce a Common Language Runtime di recuperare la memoria usata da un handle (che si verifica quando DangerousAddRef il runtime chiama il metodo ReleaseHandle ). È possibile usare questo metodo per incrementare manualmente il conteggio dei riferimenti in SafeHandle un'istanza di . DangerousAddRef restituisce un valore booleano usando ref un parametro ( ) che indica se il success conteggio dei riferimenti è stato incrementato correttamente. Ciò consente alla logica del programma di eseguire il back-out in caso di errore. È necessario impostare success su prima di chiamare false DangerousAddRef . Se success è , evitare perdite di risorse true abbinando la chiamata a con una chiamata DangerousAddRef corrispondente a DangerousRelease .

Attenzione

Questo metodo è destinato agli utenti avanzati e deve essere sempre usato con attenzione. Per evitare la perdita di risorse di handle, chiamare sempre questo metodo all'interno di un'area a esecuzione vincolata in cui un'interruzione del thread non può interrompere l'elaborazione.

Si applica a

Vedi anche