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:

Codice restituito	Descrizione
E_INVALIDARG	Uno degli argomenti non è valido.
E_UNEXPECTED	Si è verificato un errore imprevisto.
E_OUTOFMEMORY	Memoria insufficiente disponibile per questa operazione.

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

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	oleidl.h

Vedi anche

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::Onstop