CreateRandomAccessStreamOnFile, fonction (shcore.h)

Crée un flux d’accès aléatoire Windows Runtime pour un fichier.

Syntaxe

HRESULT CreateRandomAccessStreamOnFile(
  [in]  PCWSTR filePath,
  [in]  DWORD  accessMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Paramètres

[in] filePath

Chemin complet du fichier à encapsuler.

[in] accessMode

Valeur AccessMode qui spécifie le comportement de RandomAccessStream qui encapsule le fichier.

[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 demandé dans riid, généralement le IRandomAccessStream qui encapsule le fichier.

Valeur retournée

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

Remarques

Utilisez la fonction CreateRandomAccessStreamOnFile pour créer un RandomAccessStream qui encapsule un fichier.

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

Voir aussi

CreateRandomAccessStreamOverStream

CreateStreamOverRandomAccessStream

RandomAccessStream