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

Confira também

Ioleadviseholder

Ioleobject