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

Voir aussi

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertIStorageToOLESTREAMEx

OleConvertOLESTREAMToIStorage

STGMEDIUM

TYMED