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

Source:: SafeHandle.cs

Source:: SafeHandle.cs

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

SafeHandle è stato eliminato.

Commenti

Il DangerousAddRef metodo impedisce a 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 incrementare manualmente il conteggio dei riferimenti in un'istanza SafeHandle di . DangerousAddRef restituisce un valore booleano utilizzando un ref parametro (success) che indica se il conteggio dei riferimenti è stato incrementato correttamente. In questo modo la logica del programma può eseguire il backout in caso di errore. È necessario impostare su successfalse prima di chiamare DangerousAddRef. Se success è true, evitare perdite di risorse associando la chiamata a DangerousAddRef con una chiamata corrispondente a DangerousRelease.

Se la chiamata ha esito positivo, il parametro true verrà impostato ref bool success su e restituito 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()