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 numero di 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
RCW da rilasciare.
Valori restituiti
Nuovo valore del conteggio dei riferimenti dell'RCW associato al o parametro , ovvero 0 (zero) se la versione ha esito positivo.
- Attributi
Eccezioni
o non è un oggetto COM valido.
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.
L'oggetto COM non può essere utilizzato dopo che è stato separato dal relativo RCW sottostante. Se si tenta di chiamare un metodo nell'RCW dopo che il conteggio dei riferimenti diventa 0, verrà generata un'eccezione InvalidComObjectException .
