OleConvertIStorageToOLESTREAMEx, fonction (ole2.h)

Article
03/04/2024

La fonction OleConvertIStorageToOLESTREAMEx convertit l’objet de stockage spécifié du stockage structuré OLE 2 en modèle objet de stockage OLE 1, y compris les données de présentation. Il s’agit de l’une des nombreuses fonctions incluses dans le stockage structuré pour garantir la compatibilité entre OLE1 et OLE2.

Syntaxe

HRESULT OleConvertIStorageToOLESTREAMEx(
  [in]  LPSTORAGE   pstg,
  [in]  CLIPFORMAT  cfFormat,
  [in]  LONG        lWidth,
  [in]  LONG        lHeight,
  [in]  DWORD       dwSize,
  [in]  LPSTGMEDIUM pmedium,
  [out] LPOLESTREAM polestm
);

Paramètres

[in] pstg

Pointeur vers l’interface IStorage sur l’objet de stockage à convertir en stockage OLE 1.

[in] cfFormat

Format des données de présentation. Peut être NULL, auquel cas les paramètres lWidth, lHeight, dwSize et pmedium sont ignorés.

[in] lWidth

Largeur des données de présentation d’objet en unités HIMETRIC.

[in] lHeight

Hauteur des données de présentation d’objet en unités HIMETRIC.

[in] dwSize

Taille des données, en octets, à convertir.

[in] pmedium

Pointeur vers la structure STGMEDIUM pour les données sérialisées à convertir.

[out] polestm

Pointeur vers un flux où la représentation persistante de l’objet est enregistrée à l’aide du modèle de stockage OLE 1.

Valeur retournée

Cette fonction prend en charge la valeur de retour standard E_INVALIDARG, en plus des éléments suivants :

Remarques

La fonction OleConvertIStorageToOLESTREAMEx convertit un objet de stockage OLE 2 au format OLE 1. Elle diffère de la fonction OleConvertIStorageToOLESTREAM en ce que la fonction OleConvertIStorageToOLESTREAMEx transmet également les données de présentation à l’objet de stockage OLE 1, contrairement à la fonction OleConvertIStorageToOLESTREAM .

Étant donné que OleConvertIStorageToOLESTREAMEx peut spécifier les données de présentation à convertir, il peut être utilisé par les applications qui n’utilisent pas de ressources de mise en cache OLE par défaut, mais qui utilisent les ressources de conversion d’OLE.

La valeur du membre tymé de STGMEDIUM doit être TYMED_HGLOBAL ou TYMED_ISTREAM ; pour plus d’informations, reportez-vous à l’énumération TYMED . Le support n’est pas libéré par la fonction OleConvertIStorageToOLESTREAMEx .

Configuration requise

Condition requise	Valeur
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	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll