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

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

Синтаксис

HRESULT CreateRandomAccessStreamOnFile(
  [in]  PCWSTR filePath,
  [in]  DWORD  accessMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Параметры

[in] filePath

Полный путь к файлу для инкапсуляции.

[in] accessMode

Значение AccessMode , указывающее поведение RandomAccessStream , инкапсулирующего файл.

[in] riid

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

[out] ppv

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

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

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

Комментарии

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

Мы рекомендуем использовать макрос 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

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

CreateRandomAccessStreamOverStream

CreateStreamOverRandomAccessStream

RandomAccessStream