IUnknown::AddRef

9/8/2008

Esse método aumenta o contagem de referência para uma interface em um objeto. Ele deve ser chamado para cada novo copiar de um ponteiro para uma interface em um objeto especificado.

Syntax

ULONG AddRef(void);

Parameters

Nenhum.

Return Value

Retorna um inteiro de 1 para n, o valor da nova contagem de referência. Este informações serve para ser usado para diagnóstico/testes fins somente, porque, em determinadas situações, o valor pode estar instável.

Remarks

Objetos usam um mecanismo contagem de referência para garantir que a tempo de vida do objeto inclui a tempo de vida de referências a ele. Você usa IUnknown::AddRef Para estabilizar um copiar de um ponteiro interface. Ele também pode ser chamado quando a vida de um ponteiro clonado deve estender além de tempo de vida do original ponteiro. O ponteiro clonado deve ser lançado por chamado de IUnknown::Release método.

Os objetos devem poder manter (231) – 1 pendente referências ponteiro. Portanto, a referência interna contador que IUnknown::AddRef Mantém deve ser um 32-bit unsigned integer.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Chamar esta função para cada novo copiar de um ponteiro interface que você fizer. De exemplo, se você estiver passando um copiar de um ponteiro voltar de uma função, você deve chamar IUnknown::AddRef Em que ponteiro.

Você também deve chamar IUnknown::AddRef Em um ponteiro antes de transmiti-la como um parâmetro in-out para uma função; a função será chamar IUnknown::Release Antes de copiar o out-value em parte superior dele.

Requirements

See Also

Reference

IUnknown::Release