Disminuye el valor del contador de referencias del contenedor al que se puede llamar en tiempo de ejecución.
Espacio de nombres: System.Runtime.InteropServices
Ensamblado: mscorlib (en mscorlib.dll)
Sintaxis
Visual Basic (Declaración)
Public Shared Function ReleaseComObject ( _
o As Object _
) As Integer
Dim o As Object
Dim returnValue As Integer
returnValue = Marshal.ReleaseComObject(o)
public static int ReleaseComObject (
Object o
)
public:
static int ReleaseComObject (
Object^ o
)
public static int ReleaseComObject (
Object o
)
public static function ReleaseComObject (
o : Object
) : int
Parámetros
- o
Objeto COM que se va a liberar.
Valor devuelto
Nuevo valor del contador de referencias del contenedor al que se puede llamar en tiempo de ejecución y que está asociado a
o. Este valor suele ser cero ya que el contenedor al que se puede llamar en tiempo de ejecución conserva una sola referencia al objeto COM incluido en el contenedor, independientemente del número de clientes administrados que lo llamen.
Excepciones
| Tipo de excepción | Condición |
|---|
ArgumentException | o no es un objeto COM válido. O bien o es referencia de objeto null (Nothing en Visual Basic). |
Comentarios
Cada vez que un puntero de interfaz COM utiliza Common Language Runtime, se incluye en un contenedor al que se puede llamar en tiempo de ejecución. Si no está familiarizado con las características de este contenedor, vea Contenedor al que se puede llamar en tiempo de ejecución.
Este método se utiliza para controlar de manera explícita la vida de un objeto COM utilizado en el código administrado. Debe utilizar este método para liberar adecuadamente el objeto COM subyacente que conserva referencias a los recursos o cuando los objetos deben liberarse en un orden específico.
Este contenedor al que se puede llamar en tiempo de ejecución tiene un contador de referencia que se incrementa cada vez que se le asigna un puntero de interfaz COM. El método ReleaseComObject disminuye el valor del contador de referencias de un contenedor al que se puede llamar en tiempo de ejecución. Cuando el contador de referencias llega a cero, el motor en tiempo de ejecución libera todas sus referencias en el objeto COM no administrado y produce una excepción System.NullReferenceException si intenta seguir utilizando el objeto. Si se pasa varias veces la misma interfaz COM de código no administrado a código administrado, el contador de referencias del contenedor se incrementa cada vez y, al llamar al método ReleaseComObject, se devuelve el número de referencias restantes.
.gif) Nota |
|---|
| Para asegurarse de que se liberan el contenedor al que se puede llamar en tiempo de ejecución y el objeto COM original, cree un bucle para llamar a este método hasta que el valor devuelto del contador de referencias llegue a cero. |
Seguridad de .NET Framework
Plataformas
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 2.0
Vea también