Funzione CreateRandomAccessStreamOverStream (shcore.h)

Crea un flusso di accesso casuale Windows Runtime intorno a un'implementazione di base IStream.

Sintassi

HRESULT CreateRandomAccessStreamOverStream(
  [in]  IStream      *stream,
  [in]  BSOS_OPTIONS options,
  [in]  REFIID       riid,
  [out] void         **ppv
);

Parametri

[in] stream

Flusso COM da incapsulare.

[in] options

Una delle opzioni BSOS_OPTIONS che specificano il comportamento del flusso RandomAccessStream che incapsula il flusso.

[in] riid

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_RandomAccessStream.

[out] ppv

Quando questo metodo viene restituito correttamente, contiene il puntatore di interfaccia al randomAccessStream che incapsula il flusso richiesto in riid.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Usare la funzione CreateRandomAccessStreamOverStream per creare un oggetto RandomAccessStream che incapsula un IStream COM.

Per informazioni sulle classi di utilità utili per l'interoperabilità tra Windows Runtime e flussi COM, vedi la sezione Osservazioni su RandomAccessStreamOverStream.

È consigliabile usare la macro IID_PPV_ARGS , definita in Objbase.h, per creare un 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

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream