Condividi tramite


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

Eccezioni

L'oggetto SafeHandle è stato eliminato.

Commenti

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

Se questa chiamata ha esito positivo, imposta il ref bool success parametro su true e restituisce correttamente. Se questa chiamata ha esito negativo, genererà un'eccezione e lascerà il ref bool success parametro non modificato.

Si applica a

Vedi anche