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