Compartilhar via


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

Diminui a contagem de referência para uma interface em um objeto COM.

Sintaxe

ULONG Release();

Retornar valor

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

Comentários

Quando a contagem de referência em um objeto atinge zero, Release deve fazer com que o ponteiro da interface se libere. Quando o ponteiro liberado é a única (anteriormente) referência pendente a um objeto (se o objeto dá suporte a interfaces únicas ou múltiplas), a implementação deve liberar o objeto.

Observe que a agregação de objetos restringe a capacidade de recuperar ponteiros de interface.

Anotações aos chamadores

Chame esse método quando você não precisar mais usar um ponteiro de interface. Se você estiver escrevendo um método que usa um parâmetro de entrada, chame Release no ponteiro que você está passando antes de copiar o valor externo sobre ele.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho unknwn.h

Confira também