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 -> 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.
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
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per