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

Incrementa a contagem de referência de um ponteiro de interface para um objeto COM. Você deve chamar esse método sempre que fizer uma cópia de um ponteiro de interface

Sintaxe

ULONG AddRef();

Valor retornado

O método retorna a nova contagem de referência. Esse valor destina-se a ser usado apenas para fins de teste.

Comentários

Um objeto COM usa um mecanismo de contagem de referência por interface para garantir que o objeto não faça referências adicionais a ele. Você usa AddRef para estabilizar uma cópia de um ponteiro de interface. Ele também pode ser chamado quando a vida útil de um ponteiro clonado deve se estender além do tempo de vida do ponteiro original. O ponteiro clonado deve ser liberado chamando IUnknown::Release nele.

O contador de referência interno que AddRef mantém deve ser um inteiro sem sinal de 32 bits.

Anotações aos chamadores

Chame esse método para cada nova cópia de um ponteiro de interface que você fizer. Por exemplo, se você retornar uma cópia de um ponteiro de um método, deverá chamar AddRef nesse ponteiro. Você também deve chamar AddRef em um ponteiro antes de passá-lo como um parâmetro de entrada para um método; o método chamará IUnknown::Release antes de copiar o valor de saída em cima dele.

Requisitos

Confira também

• Interface IUnknown