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

CreateStreamOverRandomAccessStream

RandomAccessStream