IUnknown::Release

9/8/2008

Este método diminui o contagem de referência para a interface chamado em um objeto. Se o contagem de referência sobre o objeto cair para zero, o objeto é liberado de memória.

Syntax

ULONG Release(void);

Parameters

Nenhum.

Return Value

Retorna o valor resultante do contagem de referência, que é usado para diagnóstico/testes fins somente. Se você precisar saber que recursos tem sido liberados, use uma interface com a semântica de nível superior.

Remarks

Se a pasta IUnknown::AddRef método foi chamado na interface deste objeto n Horas e esse é o n + 1 chamar para IUnknown::Release, a implementação de IUnknown::AddRef deve causar o ponteiro interface para livre próprio.

Quando o ponteiro lançado é a referência existente somente a um objeto (seja o objeto oferece suporte a único ou múltiplo interfaces), a implementação deve livre de objeto.

Agregação de objetos restringe a capacidade de recuperar os ponteiros interface.

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

Notas para chamadores

Chamar esse método quando você não precisará usar um ponteiro interface. Se você estiver escrevendo uma função que usa um parâmetro in-out, chamar IUnknown::Release Sobre o ponteiro você está passando no antes de copiar o out-value em parte superior dele.

Requirements

See Also

Reference

IUnknown::AddRef