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 |