Funzione CreateRandomAccessStreamOnFile (shcore.h)
Crea un flusso di accesso casuale Windows Runtime per un file.
Sintassi
HRESULT CreateRandomAccessStreamOnFile(
[in] PCWSTR filePath,
[in] DWORD accessMode,
[in] REFIID riid,
[out] void **ppv
);
Parametri
[in] filePath
Percorso completo del file da incapsulare.
[in] accessMode
Valore AccessMode che specifica il comportamento di RandomAccessStream che incapsula il file.
[in] riid
Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_RandomAccessStream.
[out] ppv
Quando questo metodo restituisce correttamente, contiene il puntatore dell'interfaccia richiesto in riid, in genere IRandomAccessStream che incapsula il file.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Usare la funzione CreateRandomAccessStreamOnFile per creare un oggetto RandomAccessStream che incapsula un file.
È consigliabile usare la macro IID_PPV_ARGS definita in Objbase.h per creare il pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica in riid che potrebbe causare risultati imprevisti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | shcore.h |
| Libreria | Shcore.lib |
| DLL | Shcore.dll |
Vedi anche
CreateRandomAccessStreamOverStream