Funzione CreateDataCache (objbase.h)

Articolo
03/15/2023

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

Condividi tramite