Marshal.FinalReleaseComObject(Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerPará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.
o es null.
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 .
