CreateRandomAccessStreamOverStream, fonction (shcore.h)

Crée un flux d’accès aléatoire Windows Runtime autour d’une implémentation de base IStream.

Syntaxe

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

Paramètres

[in] stream

Flux COM à encapsuler.

[in] options

L’une des options BSOS_OPTIONS qui spécifient le comportement de RandomAccessStream qui encapsule le flux.

[in] riid

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_RandomAccessStream.

[out] ppv

Lorsque cette méthode retourne correctement, contient le pointeur d’interface vers randomAccessStream qui encapsule le flux demandé dans riid.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Utilisez la fonction CreateRandomAccessStreamOverStream pour créer un RandomAccessStream qui encapsule un IStream COM.

Pour plus d’informations sur les classes utilitaires qui facilitent l’interopérabilité entre les flux Windows Runtime et COM, consultez les remarques sur RandomAccessStreamOverStream.

Nous vous recommandons d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage dans riid qui pourrait entraîner des résultats inattendus.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	shcore.h
Bibliothèque	ShCore.lib
DLL	ShCore.dll

Voir aussi

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream