CreateOleAdviseHolder

9/8/2008

Essa função instancia um objeto reservado Advise para gerenciar as notificações documento composto. Ele passa sem um ponteiro para OLE implementação do objeto de interface de IOleAdviseHolder.

Syntax

WINOLEAPI CreateOleAdviseHolder(
  IOleAdviseHolder FAR* FAR*  ppOAHolder
);

Parameters

• ppOAHolder
  [out] Ponteiro para IOleAdviseHoldervariável * pointer que recebe o ponteiro interface para o novo objeto reservado informar.

Return Value

Essa função retorna S_OK se ele for bem-sucedido.

Essa função retorna E_OUTOFMEMORY se ele falhar.

Remarks

A função CreateOleAdviseHolder Cria uma instância de um reservado Advise, que oferece suporte para a implementação OLE das IOleAdviseHolder interface.

Os métodos dessa interface servem para ser usado para implementar a de consultoria métodos IOleObject e, quando de consultoria conexões estão configuradas com objetos suporte um coletor de avisos, para enviar notificações de alterações no objeto para o coletor de avisos.

O reservado informar retornado por CreateOleAdviseHolder suffices para a maioria dos aplicativos.

No entanto, a implementação OLE-provided não tem suporte IOleAdviseHolder::EnumAdvise. Se você precisar usar esse método, implementar seu próprio reservado informar.

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	ole2.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
IOleAdviseHolder
IOleObject
IOleAdviseHolder::EnumAdvise

Concepts

Determining Supported COM APIs