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