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

CreateStreamOverRandomAccessStream

RandomAccessStream