Função OleConvertOLESTREAMToIStorageEx (ole2.h)
A função OleConvertOLESTREAMToIStorageEx converte o objeto especificado do modelo de armazenamento OLE 1 em um objeto de armazenamento estruturado OLE 2, incluindo dados de apresentação. Essa é uma das várias funções de compatibilidade.
Sintaxe
HRESULT OleConvertOLESTREAMToIStorageEx(
[in] LPOLESTREAM polestm,
[out] LPSTORAGE pstg,
[out] CLIPFORMAT *pcfFormat,
[out] LONG *plwWidth,
[out] LONG *plHeight,
[out] DWORD *pdwSize,
[out] LPSTGMEDIUM pmedium
);
Parâmetros
[in] polestm
Ponteiro para o fluxo que contém a representação persistente do objeto no formato de armazenamento OLE 1.
[out] pstg
Ponteiro para o objeto de armazenamento estruturado OLE 2.
[out] pcfFormat
Ponteiro para onde o formato dos dados da apresentação é retornado. Pode ser NULL, indicando a ausência de dados de apresentação.
[out] plwWidth
Ponteiro para onde o valor de largura (em HIMETRIC) dos dados de apresentação é retornado.
[out] plHeight
Ponteiro para onde o valor de altura (em HIMETRIC) dos dados de apresentação é retornado.
[out] pdwSize
Ponteiro para onde o tamanho em bytes dos dados convertidos é retornado.
[out] pmedium
Ponteiro para onde a estrutura STGMEDIUM para os dados serializados convertidos é retornada.
Retornar valor
Essa função retorna HRESULT.
Comentários
Essa função converte um objeto OLE 1 em um objeto de armazenamento estruturado OLE 2. Você pode usar essa função para atualizar objetos OLE 1 para objetos OLE 2 quando uma nova versão do aplicativo de objeto dá suporte ao OLE 2.
Essa função difere da função OleConvertOLESTREAMToIStorage , na qual os dados de apresentação lidos da estrutura OLESTREAM são passados e o objeto de armazenamento OLE 2 recém-criado não contém um fluxo de apresentação.
Como essa função pode especificar quais dados de apresentação converter, ela pode ser usada por aplicativos que não usam os recursos de cache padrão do OLE, mas usam os recursos de conversão.
O membro tymed de STGMEDIUM só pode ser TYMED_NULL ou TYMED_ISTREAM. Se for TYMED_NULL, os dados serão retornados em um identificador global por meio do membro hGlobal de STGMEDIUM, caso contrário, os dados serão gravados no membro pstm dessa estrutura.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ole2.h |
| Biblioteca | Ole32.lib |
| DLL | Ole32.dll |