Función CreateRandomAccessStreamOnFile (shcore.h)
Crea un flujo de acceso aleatorio Windows Runtime para un archivo.
Sintaxis
HRESULT CreateRandomAccessStreamOnFile(
[in] PCWSTR filePath,
[in] DWORD accessMode,
[in] REFIID riid,
[out] void **ppv
);
Parámetros
[in] filePath
Ruta de acceso completa del archivo que se va a encapsular.
[in] accessMode
Valor de AccessMode que especifica el comportamiento de RandomAccessStream que encapsula el archivo.
[in] riid
Referencia al IID de la interfaz que se va a recuperar a través de ppv, normalmente IID_RandomAccessStream.
[out] ppv
Cuando este método se devuelve correctamente, contiene el puntero de interfaz solicitado en riid, normalmente el IRandomAccessStream que encapsula el archivo.
Valor devuelto
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Use la función CreateRandomAccessStreamOnFile para crear un RandomAccessStream que encapsula un archivo.
Se recomienda usar la macro IID_PPV_ARGS , definida en Objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor de ppv, lo que elimina la posibilidad de un error de codificación en riid que podría dar lugar a resultados inesperados.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | shcore.h |
| Library | Shcore.lib |
| Archivo DLL | Shcore.dll |
Consulte también
CreateRandomAccessStreamOverStream