IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle メソッド (windowsstoragecom.h)
StorageFile.OpenAsync メソッドが作成したランダム アクセス バイト ストリームからハンドルを取得し、ハンドルの日和見ロックが解除されたときに実行するコールバック メソッドを登録します。
構文
HRESULT OpenUnbufferedFileHandle(
[in] IUnbufferedFileHandleOplockCallback *oplockBreakCallback,
[out, retval] DWORD_PTR *fileHandle
);
パラメーター
[in] oplockBreakCallback
ハンドルの日和見ロックが解除されたときに実行する IUnbufferedFileHandleOplockCallback::OnBrokenCallback メソッドの実装を含むインターフェイス。
[out, retval] fileHandle
ランダム アクセス バイト ストリームからのハンドル。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle は、GENERIC_READ用に開かれている新しいハンドルを開きます。 IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle は、ストリームの基になる実際のハンドルまたはそのハンドルの重複を返しません。
ハンドルが不要になったら 、IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle を呼び出します。 また、日和見ロックが解除されるとハンドルは閉じられます。そのため、コードはハンドルが無効な場合に発生する例外を処理する必要があります。
要件
| サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | windowsstoragecom.h |
| [DLL] | Windows.storage.dll |
関連項目
IUnbufferedFileHandleOplockCallback