IUnknown::Release
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
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
| Header | unknwn.h, unknwn.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |