Marshal.FinalReleaseComObject(Object) 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.
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 -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParametri
- 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.
o è null.
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.
