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
IUnbufferedFileHandleOplockCallback