OleConvertOLESTREAMToIStorageEx, fonction (ole2.h)
La fonction OleConvertOLESTREAMToIStorageEx convertit l’objet spécifié du modèle de stockage OLE 1 en objet de stockage structuré OLE 2, y compris les données de présentation. Il s’agit de l’une des nombreuses fonctions de compatibilité.
Syntaxe
HRESULT OleConvertOLESTREAMToIStorageEx(
[in] LPOLESTREAM polestm,
[out] LPSTORAGE pstg,
[out] CLIPFORMAT *pcfFormat,
[out] LONG *plwWidth,
[out] LONG *plHeight,
[out] DWORD *pdwSize,
[out] LPSTGMEDIUM pmedium
);
Paramètres
[in] polestm
Pointeur vers le flux qui contient la représentation persistante de l’objet au format de stockage OLE 1.
[out] pstg
Pointeur vers l’objet de stockage structuré OLE 2.
[out] pcfFormat
Pointeur vers l’emplacement où le format des données de présentation est retourné. Peut être NULL, indiquant l’absence de données de présentation.
[out] plwWidth
Pointeur vers l’emplacement où la valeur de largeur (en HIMETRIC) des données de présentation est retournée.
[out] plHeight
Pointeur vers l’emplacement où la valeur de hauteur (en HIMETRIC) des données de présentation est retournée.
[out] pdwSize
Pointeur vers l’emplacement où la taille en octets des données converties est retournée.
[out] pmedium
Pointeur vers l’emplacement où la structure STGMEDIUM pour les données sérialisées converties est retournée.
Valeur retournée
Cette fonction retourne HRESULT.
Remarques
Cette fonction convertit un objet OLE 1 en objet de stockage structuré OLE 2. Vous pouvez utiliser cette fonction pour mettre à jour des objets OLE 1 vers des objets OLE 2 lorsqu’une nouvelle version de l’application objet prend en charge OLE 2.
Cette fonction diffère de la fonction OleConvertOLESTREAMToIStorage en ce que les données de présentation lues à partir de la structure OLESTREAM sont transmises et que l’objet de stockage OLE 2 nouvellement créé ne contient pas de flux de présentation.
Étant donné que cette fonction peut spécifier les données de présentation à convertir, elle peut être utilisée par les applications qui n’utilisent pas les ressources de mise en cache par défaut d’OLE, mais qui utilisent les ressources de conversion.
Le membre tylé de STGMEDIUM ne peut être TYMED_NULL ou TYMED_ISTREAM. Si elle est TYMED_NULL, les données sont retournées dans un handle global via le membre hGlobal de STGMEDIUM. Sinon, les données seront écrites dans le membre pstm de cette structure.
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 |