OleConvertIStorageToOLESTREAMEx, fonction (ole2.h)
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 |