Método IUnknown::Release (unknwn.h)

  • Artículo

Disminuye el recuento de referencias de una interfaz en un objeto COM.

Sintaxis

ULONG Release();

Valor devuelto

El método devuelve el nuevo recuento de referencias. Este valor está pensado para usarse únicamente con fines de prueba.

Comentarios

Cuando el recuento de referencias de un objeto alcanza cero, Release debe hacer que el puntero de interfaz se libere a sí mismo. Cuando el puntero liberado es la única referencia pendiente (anteriormente) a un objeto (si el objeto admite interfaces únicas o múltiples), la implementación debe liberar el objeto.

Tenga en cuenta que la agregación de objetos restringe la capacidad de recuperar punteros de interfaz.

Notas a los autores de llamadas

Llame a este método cuando ya no necesite usar un puntero de interfaz. Si está escribiendo un método que toma un parámetro de salida, llame a Release en el puntero que va a pasar antes de copiar el valor fuera de él.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado unknwn.h

Consulte también