Compartir a través de


Función CreateRandomAccessStreamOverStream (shcore.h)

Crea un flujo de acceso aleatorio Windows Runtime alrededor de una implementación base de IStream.

Sintaxis

HRESULT CreateRandomAccessStreamOverStream(
  [in]  IStream      *stream,
  [in]  BSOS_OPTIONS options,
  [in]  REFIID       riid,
  [out] void         **ppv
);

Parámetros

[in] stream

Secuencia COM que se va a encapsular.

[in] options

Una de las opciones de BSOS_OPTIONS que especifican el comportamiento de RandomAccessStream que encapsula la secuencia.

[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 vuelve correctamente, contiene el puntero de interfaz a RandomAccessStream que encapsula la secuencia solicitada en riid.

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 CreateRandomAccessStreamOverStream para crear un objeto RandomAccessStream que encapsula un IStream COM.

Para obtener información sobre las clases de utilidad que ayudan con la interoperación entre Windows Runtime y secuencias COM, consulta los comentarios en RandomAccessStreamOverStream.

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 en 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

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream