SafeHandle.DangerousAddRef(Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitmember this.DangerousAddRef : bool -> unitPublic 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.
