IOleCacheControl::OnRun-Methode (oleidl.h)

  • Artikel

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
E_INVALIDARG
 Eines der Argumente ist ungültig.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.
E_OUTOFMEMORY
 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

Weitere Informationen

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop