Marshal.FinalReleaseComObject(Object) Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblados:

netstandard.dll, System.Runtime.InteropServices.dll

Source:

Marshal.NoCom.cs

Libera todas las referencias a un contenedor RCW estableciendo su recuento de referencias en 0.

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject(object o);

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

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

Consulte también

• ReleaseComObject(Object)
• NullReferenceException