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