Метод 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 |
| Header | windowsstoragecom.h |
| DLL | Windows.storage.dll |
См. также раздел
IUnbufferedFileHandleOplockCallback