IUnbufferedFileHandleProvider：：OpenUnbufferedFileHandle 方法 (windowsstoragecom.h)

项目
08/27/2023

从 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