Méthode IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle (windowsstoragecom.h)
Obtient un handle à partir d’un flux d’octets à accès aléatoire que la méthode StorageFile.OpenAsync a créée et inscrit une méthode de rappel que vous souhaitez exécuter lorsque le verrou opportuniste du handle est rompu.
Syntaxe
HRESULT OpenUnbufferedFileHandle(
[in] IUnbufferedFileHandleOplockCallback *oplockBreakCallback,
[out, retval] DWORD_PTR *fileHandle
);
Paramètres
[in] oplockBreakCallback
Interface qui contient l’implémentation de la méthode IUnbufferedFileHandleOplockCallback::OnBrokenCallback que vous souhaitez exécuter lorsque le verrou opportuniste du handle est rompu.
[out, retval] fileHandle
Handle du flux d’octets à accès aléatoire.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle ouvre un nouveau handle ouvert pour GENERIC_READ. IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle ne retourne pas le handle sous-jacent réel du flux, ni un doublon de ce handle.
Appelez IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle lorsque vous n’avez plus besoin du handle. Le handle est également fermé lorsque le verrou opportuniste se brise, de sorte que votre code doit traiter les exceptions qui se produisent lorsque le handle n’est pas valide.
Configuration requise
| Client minimal pris en charge | Windows 10 (applications de bureau uniquement) |
| Serveur minimal pris en charge | Windows Server 2016 (applications de bureau uniquement) |
| Plateforme cible | Windows |
| En-tête | windowsstoragecom.h |
| DLL | Windows.storage.dll |
Voir aussi
IUnbufferedFileHandleOplockCallback