IOleCacheControl::OnRun-Methode (oleidl.h)
Benachrichtigt den Cache, dass das Datenquellenobjekt den Ausführungsstatus erreicht hat, damit das Cacheobjekt bei Bedarf Empfehlungssenken einrichten kann.
Syntax
HRESULT OnRun(
[in] LPDATAOBJECT pDataObject
);
Parameter
[in] pDataObject
Ein Zeiger auf die IDataObject-Schnittstelle für das Objekt, das in den Ausführungszustand wechselt.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Eines der Argumente ist ungültig. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar. |
Hinweise
Wenn OnRun aufgerufen wird, richtet der Cache bei Bedarf Beratungsverbindungen mit dem Quelldatenobjekt ein, damit es Benachrichtigungen empfangen kann. Die zwischen dem ausgeführten Objekt und dem Cache erstellte Empfehlungsverbindung wird zerstört, wenn IOleCacheControl::OnStop aufgerufen wird.
Einige Objekthandler oder prozessinterne Server verwenden den Cache möglicherweise passiv und rufen OnRun nicht auf. Diese Anwendungen müssen IOleCache2::UpdateCache, IOleCache::InitCache oder IOleCache::SetData aufrufen, um den Cache bei Bedarf zu füllen, um sicherzustellen, dass der Cache aktualisiert wird.
OnRun fügt keine Verweisanzahl für den Zeiger auf das in pDataObject übergebene IDataObject hinzu. Da der Aufrufer von OleRun dafür verantwortlich ist, sicherzustellen, dass die Lebensdauer des pDataObject-Zeigers so lange dauert, bis OnStop aufgerufen wird, muss der Aufrufer einen Zeiger auf IDataObject auf dem betreffenden Datenobjekt halten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | oleidl.h |