IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle-Methode (windowsstoragecom.h)
Ruft ein Handle aus einem Bytestream mit zufälligem Zugriff ab, den die StorageFile.OpenAsync-Methode erstellt hat, und registriert eine Rückrufmethode, die Ausgeführt werden soll, wenn die opportunistische Sperre für das Handle unterbrochen ist.
Syntax
HRESULT OpenUnbufferedFileHandle(
[in] IUnbufferedFileHandleOplockCallback *oplockBreakCallback,
[out, retval] DWORD_PTR *fileHandle
);
Parameter
[in] oplockBreakCallback
Eine Schnittstelle, die die Implementierung der IUnbufferedFileHandleOplockCallback::OnBrokenCallback-Methode enthält, die Ausgeführt werden soll, wenn die opportunistische Sperre für das Handle unterbrochen ist.
[out, retval] fileHandle
Das Handle aus dem Bytestream mit zufälligem Zugriff.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle öffnet ein neues Handle, das für GENERIC_READ geöffnet ist. IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle gibt nicht das dem Stream zugrunde liegende Handle oder ein Duplikat dieses Handle zurück.
Rufen Sie IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle auf, wenn Sie das Handle nicht mehr benötigen. Das Handle wird auch geschlossen, wenn die opportunistische Sperre unterbrochen wird. Daher muss Ihr Code Ausnahmen verarbeiten, die auftreten, wenn das Handle ungültig ist.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | windowsstoragecom.h |
| DLL | Windows.storage.dll |
Weitere Informationen
IUnbufferedFileHandleOplockCallback