CreateDataCache, fonction (objbase.h)

Article
08/25/2023

Récupère un pointeur vers une nouvelle instance d’une implémentation fournie par OLE d’un cache de données.

Syntaxe

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

Paramètres

[in] pUnkOuter

Si le cache doit être créé dans le cadre d’un agrégat, pointeur vers le contrôle IUnknown de l’agrégat. Si ce n’est pas le cas, le paramètre doit être NULL.

[in] rclsid

CLSID utilisé pour générer des étiquettes d’icônes. Cette valeur est généralement CLSID_NULL.

[in] iid

Référence à l’identificateur de l’interface que l’appelant souhaite utiliser pour communiquer avec le cache. Cette valeur est généralement IID_IOleCache (définie dans les en-têtes OLE pour être égale à l’identificateur d’interface pour IOleCache).

[out] ppv

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvObj contient le pointeur d’interface demandé vers l’objet de cache fourni.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour	Description
E_NOINTERFACE	L’interface représentée par riid n’est pas prise en charge par l’objet . Le paramètre ppvObj a la valeur NULL.
E_OUTOFMEMORY	Mémoire insuffisante pour l’opération.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.

Notes

L’objet de cache créé par CreateDataCache prend en charge les interfaces IOleCache, IOleCache2 et IOleCacheControl pour le contrôle du cache. Il prend également en charge les interfaces IPersistStorage, IDataObject (sans récepteurs de conseil), IViewObject et IViewObject2 .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objbase.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-5 (introduit dans Windows 10, version 10.0.15063)

Voir aussi

IOleCache

IOleCache2

IOleCacheControl

Partager via