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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ole2.h |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |