CreateRandomAccessStreamOnFile 関数 (shcore.h)

ファイルのWindows ランタイムランダム アクセス ストリームを作成します。

構文

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

パラメーター

[in] filePath

カプセル化するファイルの完全修飾パス。

[in] accessMode

ファイルをカプセル化する RandomAccessStream の動作を指定する AccessMode 値。

[in] riid

ppv を介して取得するインターフェイスの IID への参照 。通常はIID_RandomAccessStream。

[out] ppv

このメソッドが正常に返されると、 riid で要求されたインターフェイス ポインター (通常はファイルをカプセル化する IRandomAccessStream ) が含まれます。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

CreateRandomAccessStreamOnFile 関数を使用して、ファイルをカプセル化する RandomAccessStream を作成します。

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されている IID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、 riid でコーディング エラーが発生し、予期しない結果が発生する可能性がなくなります。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	shcore.h
Library	Shcore.lib
[DLL]	Shcore.dll

こちらもご覧ください

CreateRandomAccessStreamOverStream

CreateStreamOverRandomAccessStream

RandomAccessStream