Função CreateOleAdviseHolder (ole2.h)
Cria um objeto de titular de consultoria para gerenciar notificações compostas de documentos. Ele retorna um ponteiro para a implementação OLE do objeto da interface IOleAdviseHolder .
Sintaxe
HRESULT CreateOleAdviseHolder(
[out] LPOLEADVISEHOLDER *ppOAHolder
);
Parâmetros
[out] ppOAHolder
Endereço da variável de ponteiro IOleAdviseHolder que recebe o ponteiro de interface para o novo objeto de titular de consultoria.
Retornar valor
Essa função retorna S_OK com êxito e dá suporte ao valor de retorno padrão E_OUTOFMEMORY.
Comentários
A função CreateOleAdviseHolder cria uma instância de um titular de consultoria, que dá suporte à implementação OLE da interface IOleAdviseHolder . Os métodos dessa interface devem ser usados para implementar os métodos consultivos do IOleObject e, quando as conexões de consultoria tiverem sido configuradas com objetos que dão suporte a um coletor de consultoria, para enviar notificações de alterações no objeto para o coletor de consultoria. O titular da consultoria retornado por CreateOleAdviseHolder será suficiente para a grande maioria dos aplicativos. No entanto, a implementação fornecida por OLE não dá suporte a IOleAdviseHolder::EnumAdvise, portanto, se você precisar usar esse método, precisará implementar seu próprio titular de consultoria.
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 | ole2.h |
| Biblioteca | Ole32.lib |
| DLL | Ole32.dll |
| Conjunto de APIs | ext-ms-win-com-ole32-l1-1-3 (introduzido no Windows 10, versão 10.0.10240) |