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

  • Artículo

Incrementa el recuento de referencias de un puntero de interfaz a un objeto COM. Debe llamar a este método cada vez que realice una copia de un puntero de interfaz.

Sintaxis

ULONG AddRef();

Valor devuelto

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

Comentarios

Un objeto COM usa un mecanismo de recuento de referencias por interfaz para asegurarse de que el objeto no sobrevive a las referencias a él. Use AddRef para estabilizar una copia de un puntero de interfaz. También se puede llamar cuando la vida de un puntero clonado debe extenderse más allá de la duración del puntero original. El puntero clonado debe liberarse llamando a IUnknown::Release en él.

El contador de referencia interno que mantiene AddRef debe ser un entero de 32 bits sin signo.

Notas a los autores de llamadas

Llame a este método para cada nueva copia de un puntero de interfaz que realice. Por ejemplo, si devuelve una copia de un puntero desde un método, debe llamar a AddRef en ese puntero. También debe llamar a AddRef en un puntero antes de pasarlo como un parámetro de salida a un método; El método llamará a IUnknown::Release antes de copiar el valor fuera de él.

Requisitos

   
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