Funzione CreateDataCache (objbase.h)

Recupera un puntatore a una nuova istanza di un'implementazione fornita da OLE di una cache dei dati.

Sintassi

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

Parametri

[in] pUnkOuter

Se la cache deve essere creata come parte di un'aggregazione, puntatore al controllo IUnknown dell'aggregazione. In caso contrario, il parametro deve essere NULL.

[in] rclsid

CLSID usato per generare etichette icona. Questo valore è in genere CLSID_NULL.

[in] iid

Riferimento all'identificatore dell'interfaccia che il chiamante vuole usare per comunicare con la cache. Questo valore viene in genere IID_IOleCache (definito nelle intestazioni OLE in modo che corrisponda all'identificatore di interfaccia per IOleCache).

[out] ppv

Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore di interfaccia richiesto all'oggetto cache fornito.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito Descrizione
E_NOINTERFACE
L'interfaccia rappresentata da riid non è supportata dall'oggetto . Il parametro ppvObj è impostato su NULL.
E_OUTOFMEMORY
Memoria insufficiente per l'operazione.
E_INVALIDARG
Uno o più parametri non sono validi.

Commenti

L'oggetto cache creato da CreateDataCache supporta le interfacce IOleCache, IOleCache2 e IOleCacheControl per controllare la cache. Supporta anche le interfacce IPersistStorage, IDataObject (senza sink di avviso), IViewObject e IViewObject2 .

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione objbase.h
Libreria Ole32.lib
DLL Ole32.dll
Set di API ext-ms-win-com-ole32-l1-1-5 (introdotto in Windows 10, versione 10.0.15063)

Vedi anche

IOleCache

IOleCache2

IOleCacheControl