Metodo IOleCacheControl::OnRun (oleidl.h)

Notifica alla cache che l'oggetto origine dati ha immesso lo stato di esecuzione in modo che l'oggetto cache possa stabilire sink in base alle esigenze.

Sintassi

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

Parametri

[in] pDataObject

Puntatore all'interfaccia IDataObject sull'oggetto che sta immettendo lo stato di esecuzione.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Commenti

Quando viene chiamato OnRun , la cache configura le connessioni consultive in base alle esigenze con l'oggetto dati di origine in modo che possa ricevere notifiche. La connessione consultiva creata tra l'oggetto in esecuzione e la cache viene eliminata definitivamente quando viene chiamato IOleCacheControl::OnStop .

Alcuni gestori di oggetti o server in-process potrebbero usare la cache passivamente e non chiamare OnRun. Queste applicazioni devono chiamare IOleCache2::UpdateCache, IOleCache::InitCache o IOleCache::SetData per riempire la cache quando necessario per assicurarsi che la cache venga aggiornata.

OnRun non aggiunge un conteggio dei riferimenti sul puntatore a IDataObject passato in pDataObject. Poiché è responsabilità del chiamante di OleRun garantire che la durata del puntatore pDataObject dura fino a quando non viene chiamato OnStop , il chiamante deve tenere un puntatore a IDataObject sull'oggetto dati di interesse.

Requisiti

Vedi anche

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::Onstop