CreateDataCache-Funktion (objbase.h)
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 |
|---|---|
|
Die durch riid dargestellte Schnittstelle wird vom -Objekt nicht unterstützt. Der Parameter ppvObj ist auf NULL festgelegt. |
|
Unzureichender Arbeitsspeicher für den Vorgang. |
|
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) |