Функция CreateRandomAccessStreamOverStream (shcore.h)

  • Статья

Создает поток среда выполнения Windows произвольного доступа вокруг базовой реализации IStream.

Синтаксис

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

Параметры

[in] stream

Инкапсулируемый COM-поток.

[in] options

Один из BSOS_OPTIONS параметров, определяющих поведение RandomAccessStream , инкапсулирующего поток.

[in] riid

Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_RandomAccessStream.

[out] ppv

При успешном возвращении этого метода содержит указатель интерфейса на RandomAccessStream , который инкапсулирует поток , запрошенный в riid.

Возвращаемое значение

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Используйте функцию CreateRandomAccessStreamOverStream , чтобы создать RandomAccessStream , инкапсулирующий COM IStream.

Сведения о служебных классах, которые помогают в взаимодействии между потоками среда выполнения Windows и COM, см. в разделе Примечания в RandomAccessStreamOverStream.

Мы рекомендуем использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный КОД на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кодирования в riid , которая может привести к непредвиденным результатам.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header shcore.h
Библиотека ShCore.lib
DLL ShCore.dll

См. также раздел

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream