Функция 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