Marshal.FinalReleaseComObject(Object) Método

Referencia

Definición

Espacio de nombres:: System.Runtime.InteropServices

Ensamblado:: System.Runtime.InteropServices.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

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 -> 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

Int32

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: SecurityCriticalAttribute SupportedOSPlatformAttribute

Excepciones

ArgumentException

o no es un objeto COM válido.

ArgumentNullException

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 .

Se aplica a