共用方式為


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

另請參閱

IRandomAccessStream

IUnbufferedFileHandleOplockCallback

IUnbufferedFileHandleOplockCallback::OnBrokenCallback

IUnbufferedFileHandleProvider

IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle