Marshal.FinalReleaseComObject(Object) Método

Definición

Libera todas las referencias a un contenedor RCW estableciendo su recuento de referencias en 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

Parámetros

o
Object

RCW que se va a liberar.

Devoluciones

Nuevo valor del recuento de referencias del RCW asociado al parámetro o, que es 0 (cero) si la liberación se realiza correctamente.

Atributos

Excepciones

o no es un objeto COM válido.

Comentarios

El FinalReleaseComObject método libera la referencia administrada a un objeto COM. Llamar a este método equivale a llamar al ReleaseComObject método en un bucle hasta que devuelve 0 (cero).

Cuando el recuento de referencias del objeto COM se convierte en 0, el objeto COM normalmente se libera, aunque esto depende de la implementación del objeto COM y está fuera del control del tiempo de ejecución. Sin embargo, el RCW todavía puede existir, esperando ser recolección de elementos no utilizados.

El objeto COM no se puede usar después de que se haya separado de su RCW subyacente. Si intenta llamar a un método en el RCW después de que su recuento de referencias se convierta en 0, se producirá una InvalidComObjectException excepción .

Se aplica a

Consulte también