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)

Confira também

Ioleadviseholder

Ioleobject