Funzione CreateOleAdviseHolder (ole2.h)

Crea un oggetto proprietario di consigli per la gestione delle notifiche di documenti composti. Restituisce un puntatore all'implementazione OLE dell'oggetto dell'interfaccia IOleAdviseHolder .

Sintassi

HRESULT CreateOleAdviseHolder(
  [out] LPOLEADVISEHOLDER *ppOAHolder
);

Parametri

[out] ppOAHolder

Indirizzo della variabile puntatore IOleAdviseHolder che riceve il puntatore dell'interfaccia al nuovo oggetto proprietario di consulenza.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo e supporta il valore restituito standard E_OUTOFMEMORY.

Commenti

La funzione CreateOleAdviseHolder crea un'istanza di un titolare di consulenza, che supporta l'implementazione OLE dell'interfaccia IOleAdviseHolder . I metodi di questa interfaccia devono essere usati per implementare i metodi consultivi di IOleObject e, quando sono state configurate connessioni consultive con oggetti che supportano un sink di consulenza, per inviare notifiche di modifiche nell'oggetto al sink di consulenza. Il titolare della consulenza restituito da CreateOleAdviseHolder sarà sufficiente per la maggior parte delle applicazioni. L'implementazione fornita da OLE non supporta tuttavia IOleAdviseHolder::EnumAdvise, quindi se è necessario usare questo metodo, sarà necessario implementare il proprio titolare di consulenza.

Requisiti

Vedi anche

IOleAdviseHolder

Ioleobject