Marshal.FinalReleaseComObject(Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Marshal.NoCom.cs

Source:: Marshal.NoCom.cs

Source:: Marshal.NoCom.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.

Rilascia tutti i riferimenti a un Runtime Callable Wrapper (RCW) impostando il conteggio dei riferimenti su 0.

public:
 static int FinalReleaseComObject(System::Object ^ o);

[System.Security.SecurityCritical]
public static int FinalReleaseComObject (object o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);

public static int FinalReleaseComObject (object o);

[<System.Security.SecurityCritical>]
static member FinalReleaseComObject : obj -> int

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> int

static member FinalReleaseComObject : obj -> int

Public Shared Function FinalReleaseComObject (o As Object) As Integer

Parametri

o: Object

Wrapper RCW da rilasciare.

Restituisce

Int32

Nuovo valore del conteggio dei riferimenti del wrapper RCW associato al parametro o, corrispondente a 0 (zero) se il rilascio è stato eseguito correttamente.

Attributi: SecurityCriticalAttribute SupportedOSPlatformAttribute

Eccezioni

ArgumentException

o non è un oggetto COM valido.

ArgumentNullException

o è null.

Commenti

Il FinalReleaseComObject metodo rilascia il riferimento gestito a un oggetto COM. La chiamata a questo metodo equivale a chiamare il ReleaseComObject metodo in un ciclo fino a quando non restituisce 0 (zero).

Quando il conteggio dei riferimenti sull'oggetto COM diventa 0, l'oggetto COM viene in genere liberato, anche se ciò dipende dall'implementazione dell'oggetto COM e non rientra nel controllo del runtime. Tuttavia, l'RCW può ancora esistere, in attesa di essere sottoposto a Garbage Collection.

Non è possibile utilizzare l'oggetto COM dopo che è stato separato dal rcw sottostante. Se si tenta di chiamare un metodo sull'RCW dopo che il conteggio dei riferimenti diventa 0, verrà generata un'eccezione InvalidComObjectException .

Si applica a