SafeHandle.DangerousAddRef(Boolean) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.InteropServices

Assembly:: mscorlib.dll, System.Runtime.Handles.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Handles.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: netstandard.dll

Origine:: SafeHandle.cs

Origine:: SafeHandle.cs

Origine:: SafeHandle.cs

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 -> 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: SecurityCriticalAttribute

Eccezioni

ObjectDisposedException

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 DangerousAddRef DangerousRelease.

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

DangerousRelease()