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