Función CreateDataCache (objbase.h)
Recupera un puntero a una nueva instancia de una implementación proporcionada por OLE de una caché de datos.
Sintaxis
HRESULT CreateDataCache(
[in] LPUNKNOWN pUnkOuter,
[in] REFCLSID rclsid,
[in] REFIID iid,
[out] LPVOID *ppv
);
Parámetros
[in] pUnkOuter
Si la memoria caché se va a crear como parte de un agregado, puntero al IUnknown de control del agregado. Si no es así, el parámetro debe ser NULL.
[in] rclsid
CLSID usado para generar etiquetas de icono. Este valor suele ser CLSID_NULL.
[in] iid
Referencia al identificador de la interfaz que el autor de la llamada quiere usar para comunicarse con la memoria caché. Este valor suele ser IID_IOleCache (definido en los encabezados OLE para que coincidan con el identificador de interfaz de IOleCache).
[out] ppv
Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvObj contiene el puntero de interfaz solicitado al objeto de caché proporcionado.
Valor devuelto
Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El objeto no admite la interfaz representada por riid. El parámetro ppvObj se establece en NULL. |
|
Memoria insuficiente para la operación. |
|
Uno o varios parámetros no son válidos. |
Comentarios
El objeto de caché creado por CreateDataCache admite las interfaces IOleCache, IOleCache2 e IOleCacheControl para controlar la memoria caché. También admite las interfaces IPersistStorage, IDataObject (sin recibir avisos), IViewObject e IViewObject2 .
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | objbase.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |
| Conjunto de API | ext-ms-win-com-ole32-l1-1-5 (introducido en Windows 10, versión 10.0.15063) |