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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-3 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

IOleAdviseHolder

Ioleobject