Marshal.FinalReleaseComObject(Object) Metodo

Definizione

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

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

Attributi

Eccezioni

o non è un oggetto COM valido.

Commenti

Il FinalReleaseComObject metodo rilascia il riferimento gestito a un oggetto COM. La chiamata di 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 ed è oltre il controllo del runtime. Tuttavia, l'RCW può comunque esistere, in attesa di essere garbage-collection.

L'oggetto COM non può essere usato dopo che è stato separato dal relativo RCW sottostante. Se si tenta di chiamare un metodo in RCW dopo che il conteggio dei riferimenti diventa 0, verrà generata una InvalidComObjectException classe.

Si applica a

Vedi anche