Funzione OleConvertIStorageToOLESTREAMEx (ole2.h)

La funzione OleConvertIStorageToOLESTREAMEx converte l'oggetto di archiviazione specificato dall'archiviazione strutturata OLE 2 al modello a oggetti di archiviazione OLE 1, inclusi i dati della presentazione. Si tratta di una delle diverse funzioni incluse in Archiviazione strutturata per garantire la compatibilità tra OLE1 e OLE2.

Sintassi

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

Parametri

[in] pstg

Puntatore all'interfaccia IStorage nell'oggetto di archiviazione da convertire in un archivio OLE 1.

[in] cfFormat

Formato dei dati della presentazione. Può essere NULL, nel qual caso i parametri lWidth, lHeight, dwSize e pmedium vengono ignorati.

[in] lWidth

Larghezza dei dati della presentazione dell'oggetto nelle unità HIMETRIC.

[in] lHeight

Altezza dei dati della presentazione dell'oggetto nelle unità HIMETRIC.

[in] dwSize

Dimensioni dei dati, in byte, da convertire.

[in] pmedium

Puntatore alla struttura STGMEDIUM per la conversione dei dati serializzati.

[out] polestm

Puntatore a un flusso in cui viene salvata la rappresentazione persistente dell'oggetto usando il modello di archiviazione OLE 1.

Valore restituito

Questa funzione supporta il valore restituito standard E_INVALIDARG, oltre al seguente:

Commenti

La funzione OleConvertIStorageToOLESTREAMEx converte un oggetto di archiviazione OLE 2 in formato OLE 1. È diverso dalla funzione OleConvertIStorageToOLESTREAM in cui la funzione OleConvertIStorageToOLESTREAMEx passa anche i dati della presentazione all'oggetto di archiviazione OLE 1, mentre la funzione OleConvertIStorageToOLESTREAM non è.

Poiché OleConvertIStorageToOLESTREAMEx può specificare quali dati di presentazione convertire, può essere usato dalle applicazioni che non usano le risorse di memorizzazione nella cache predefinite OLE, ma utilizzano le risorse di conversione ole.

Il valore del membro tymed di STGMEDIUM deve essere TYMED_HGLOBAL o TYMED_ISTREAM; per altre informazioni, vedere l'enumerazione TYMED . Il supporto non viene rilasciato dalla funzione OleConvertIStorageToOLESTREAMEx .

Requisiti

Vedi anche

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertOLESTREAMToIStorage

OleConvertOLESTREAMToIStorageEx

STGMEDIUM

TYMED