Função OleConvertIStorageToOLESTREAMEx (ole2.h)
A função OleConvertIStorageToOLESTREAMEx converte o objeto de armazenamento especificado do armazenamento estruturado OLE 2 para o modelo de objeto de armazenamento OLE 1, incluindo os dados de apresentação. Essa é uma das várias funções incluídas no Armazenamento Estruturado para garantir a compatibilidade entre OLE1 e OLE2.
Sintaxe
HRESULT OleConvertIStorageToOLESTREAMEx(
[in] LPSTORAGE pstg,
[in] CLIPFORMAT cfFormat,
[in] LONG lWidth,
[in] LONG lHeight,
[in] DWORD dwSize,
[in] LPSTGMEDIUM pmedium,
[out] LPOLESTREAM polestm
);
Parâmetros
[in] pstg
Ponteiro para a interface IStorage no objeto de armazenamento a ser convertido em um armazenamento OLE 1.
[in] cfFormat
Formato dos dados da apresentação. Pode ser NULL; nesse caso, os parâmetros lWidth, lHeight, dwSize e pmedium são ignorados.
[in] lWidth
Largura dos dados de apresentação do objeto em unidades HIMETRIC.
[in] lHeight
Altura dos dados de apresentação do objeto em unidades HIMETRIC.
[in] dwSize
Tamanho dos dados, em bytes, a serem convertidos.
[in] pmedium
Ponteiro para a estrutura STGMEDIUM para os dados serializados a serem convertidos.
[out] polestm
Ponteiro para um fluxo em que a representação persistente do objeto é salva usando o modelo de armazenamento OLE 1.
Retornar valor
Essa função dá suporte ao valor retornado padrão E_INVALIDARG, além do seguinte:
Comentários
A função OleConvertIStorageToOLESTREAMEx converte um objeto de armazenamento OLE 2 no formato OLE 1. Ela difere da função OleConvertIStorageToOLESTREAM , pois a função OleConvertIStorageToOLESTREAMEx também passa os dados da apresentação para o objeto de armazenamento OLE 1, enquanto a função OleConvertIStorageToOLESTREAM não.
Como OleConvertIStorageToOLESTREAMEx pode especificar quais dados de apresentação converter, eles podem ser usados por aplicativos que não usam recursos de cache padrão OLE, mas usam recursos de conversão do OLE.
O valor do membro tymed de STGMEDIUM deve ser TYMED_HGLOBAL ou TYMED_ISTREAM; consulte a enumeração TYMED para obter mais informações. O meio não é liberado pela função OleConvertIStorageToOLESTREAMEx .
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 |