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

Voir aussi

IRandomAccessStream

IUnbufferedFileHandleOplockCallback

IUnbufferedFileHandleOplockCallback::OnBrokenCallback

IUnbufferedFileHandleProvider

IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle