Metodo IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle (windowsstoragecom.h)

Ottiene un handle da un flusso di byte di accesso casuale creato dal metodo StorageFile.OpenAsync e registra un metodo di callback che si vuole eseguire quando il blocco opportunistico per l'handle viene interrotto.

Sintassi

HRESULT OpenUnbufferedFileHandle(
  [in]          IUnbufferedFileHandleOplockCallback *oplockBreakCallback,
  [out, retval] DWORD_PTR                           *fileHandle
);

Parametri

[in] oplockBreakCallback

Interfaccia che contiene l'implementazione del metodo IUnbufferedFileHandleOplockCallback::OnBrokenCallback da eseguire quando il blocco opportunistico per l'handle viene interrotto.

[out, retval] fileHandle

Handle dal flusso di byte di accesso casuale.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle apre un nuovo handle aperto per GENERIC_READ. IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle non restituisce l'handle effettivo sottostante al flusso o un duplicato di tale handle.

Chiamare IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle quando non è più necessario l'handle. L'handle viene chiuso anche quando il blocco opportunistico si interrompe, pertanto il codice deve elaborare le eccezioni che si verificano quando l'handle non è valido.

Requisiti

Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windowsstoragecom.h
DLL	Windows.storage.dll

Vedi anche

IRandomAccessStream

IUnbufferedFileHandleOplockCallback

IUnbufferedFileHandleOplockCallback::OnBrokenCallback

IUnbufferedFileHandleProvider

IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle