Método IUnknown::AddRef (unknwn.h)
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 |