CreateDataCache-Funktion (objbase.h)

  • Artikel

Ruft einen Zeiger auf eine neue instance einer von OLE bereitgestellten Implementierung eines Datencaches ab.

Syntax

HRESULT CreateDataCache(
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFCLSID  rclsid,
  [in]  REFIID    iid,
  [out] LPVOID    *ppv
);

Parameter

[in] pUnkOuter

Wenn der Cache als Teil eines Aggregats erstellt werden soll, zeigen Sie auf das steuernde IUnknown des Aggregats. Andernfalls sollte der Parameter NULL sein.

[in] rclsid

CLSID zum Generieren von Symbolbezeichnungen. Dieser Wert wird in der Regel CLSID_NULL.

[in] iid

Verweis auf den Bezeichner der Schnittstelle, die der Aufrufer für die Kommunikation mit dem Cache verwenden möchte. Dieser Wert ist in der Regel IID_IOleCache (in den OLE-Headern so definiert, dass er dem Schnittstellenbezeichner für IOleCache entspricht).

[out] ppv

Adresse der Zeigervariable, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvObj den angeforderten Schnittstellenzeiger auf das angegebene Cacheobjekt.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK zurück. Weitere mögliche Werte sind:

Rückgabecode Beschreibung
E_NOINTERFACE
 Die durch riid dargestellte Schnittstelle wird vom -Objekt nicht unterstützt. Der Parameter ppvObj ist auf NULL festgelegt.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher für den Vorgang.
E_INVALIDARG
Mindestens ein Parameter ist ungültig.

Hinweise

Das von CreateDataCache erstellte Cacheobjekt unterstützt die Schnittstellen IOleCache, IOleCache2 und IOleCacheControl zum Steuern des Caches. Außerdem werden die Schnittstellen IPersistStorage, IDataObject (ohne Empfehlungssenken), IViewObject und IViewObject2 unterstützt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objbase.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-5 (eingeführt in Windows 10, Version 10.0.15063)

Weitere Informationen

IOleCache

IOleCache2

IOleCacheControl