CreateRandomAccessStreamOnFile-Funktion (shcore.h)
Erstellt einen Windows-Runtime Datenstrom für zufälligen Zugriff für eine Datei.
Syntax
HRESULT CreateRandomAccessStreamOnFile(
[in] PCWSTR filePath,
[in] DWORD accessMode,
[in] REFIID riid,
[out] void **ppv
);
Parameter
[in] filePath
Der vollqualifizierte Pfad der zu kapselnden Datei.
[in] accessMode
Ein AccessMode-Wert , der das Verhalten des RandomAccessStream angibt, der die Datei kapselt.
[in] riid
Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll, in der Regel IID_RandomAccessStream.
[out] ppv
Wenn diese Methode erfolgreich zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger, in der Regel den IRandomAccessStream , der die Datei kapselt.
Rückgabewert
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Verwenden Sie die CreateRandomAccessStreamOnFile-Funktion , um einen RandomAccessStream zu erstellen, der eine Datei kapselt.
Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in Objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers in riid beseitigt wird, der zu unerwarteten Ergebnissen führen kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shcore.h |
| Bibliothek | Shcore.lib |
| DLL | Shcore.dll |
Weitere Informationen
CreateRandomAccessStreamOverStream