Função CreateRandomAccessStreamOverStream (shcore.h)
Cria um fluxo de acesso aleatório Windows Runtime em torno de uma implementação base IStream.
Sintaxe
HRESULT CreateRandomAccessStreamOverStream(
[in] IStream *stream,
[in] BSOS_OPTIONS options,
[in] REFIID riid,
[out] void **ppv
);
Parâmetros
[in] stream
O fluxo COM a ser encapsulado.
[in] options
Uma das opções de BSOS_OPTIONS que especificam o comportamento do RandomAccessStream que encapsula o fluxo.
[in] riid
Uma referência ao IID da interface a ser recuperada por meio de ppv, normalmente IID_RandomAccessStream.
[out] ppv
Quando esse método retorna com êxito, contém o ponteiro de interface para o RandomAccessStream que encapsula o fluxo solicitado em riid.
Retornar valor
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Use a função CreateRandomAccessStreamOverStream para criar um RandomAccessStream que encapsula um IStream COM.
Para obter informações sobre classes de utilitário que ajudam na interoperação entre fluxos de Windows Runtime e COM, consulte os Comentários em RandomAccessStreamOverStream.
Recomendamos que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação no riid que pode levar a resultados inesperados.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | shcore.h |
| Biblioteca | ShCore.lib |
| DLL | ShCore.dll |
Confira também
CreateRandomAccessStreamOnFile