Funzione OleConvertOLESTREAMToIStorageEx (ole2.h)

La funzione OleConvertOLESTREAMToIStorageEx converte l'oggetto specificato dal modello di archiviazione OLE 1 a un oggetto di archiviazione strutturato OLE 2, inclusi i dati della presentazione. Si tratta di una delle diverse funzioni di compatibilità.

Sintassi

HRESULT OleConvertOLESTREAMToIStorageEx(
  [in]  LPOLESTREAM polestm,
  [out] LPSTORAGE   pstg,
  [out] CLIPFORMAT  *pcfFormat,
  [out] LONG        *plwWidth,
  [out] LONG        *plHeight,
  [out] DWORD       *pdwSize,
  [out] LPSTGMEDIUM pmedium
);

Parametri

[in] polestm

Puntatore al flusso contenente la rappresentazione persistente dell'oggetto nel formato di archiviazione OLE 1.

[out] pstg

Puntatore all'oggetto di archiviazione strutturato OLE 2.

[out] pcfFormat

Puntatore a dove viene restituito il formato dei dati della presentazione. Può essere NULL, che indica l'assenza di dati di presentazione.

[out] plwWidth

Puntatore a dove viene restituito il valore di larghezza (in HIMETRIC) dei dati della presentazione.

[out] plHeight

Puntatore a dove viene restituito il valore di altezza (in HIMETRIC) dei dati della presentazione.

[out] pdwSize

Puntatore a dove vengono restituite le dimensioni in byte dei dati convertiti.

[out] pmedium

Puntatore a dove viene restituita la struttura STGMEDIUM per i dati serializzati convertiti.

Valore restituito

Questa funzione restituisce HRESULT.

Commenti

Questa funzione converte un oggetto OLE 1 in un oggetto di archiviazione strutturato OLE 2. È possibile usare questa funzione per aggiornare gli oggetti OLE 1 a oggetti OLE 2 quando una nuova versione dell'applicazione oggetto supporta OLE 2.

Questa funzione differisce dalla funzione OleConvertOLESTREAMToIStorage in cui i dati di presentazione letti dalla struttura OLESTREAM vengono passati e l'oggetto di archiviazione OLE 2 appena creato non contiene un flusso di presentazione.

Poiché questa funzione può specificare i dati di presentazione da convertire, può essere usata dalle applicazioni che non usano le risorse di memorizzazione nella cache predefinite di OLE, ma usano le risorse di conversione.

Il membro tymed di STGMEDIUM può essere TYMED_NULL o TYMED_ISTREAM. Se è TYMED_NULL, i dati verranno restituiti in un handle globale tramite il membro hGlobal di STGMEDIUM, in caso contrario, i dati verranno scritti nel membro pstm di questa struttura.

Requisiti

Vedi anche

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertIStorageToOLESTREAMEx

OleConvertOLESTREAMToIStorage

STGMEDIUM

TYMED