Função CreateRandomAccessStreamOnFile (shcore.h)
Cria um fluxo de acesso aleatório Windows Runtime para um arquivo.
Sintaxe
HRESULT CreateRandomAccessStreamOnFile(
[in] PCWSTR filePath,
[in] DWORD accessMode,
[in] REFIID riid,
[out] void **ppv
);
Parâmetros
[in] filePath
O caminho totalmente qualificado do arquivo a ser encapsulado.
[in] accessMode
Um valor AccessMode que especifica o comportamento do RandomAccessStream que encapsula o arquivo.
[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 solicitado em riid, normalmente o IRandomAccessStream que encapsula o arquivo.
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 CreateRandomAccessStreamOnFile para criar um RandomAccessStream que encapsula um arquivo.
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
CreateRandomAccessStreamOverStream