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 |
|---|---|
|
Uno degli argomenti non è valido. |
|
Si è verificato un errore imprevisto. |
|
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 |