Функция SHCreateStreamOnFileW (shlwapi.h)

Статья
11/20/2024

[SHCreateStreamOnFile доступно для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. Вместо этого используйте SHCreateStreamOnFileEx.]

Открывает или создает файл и извлекает поток для чтения или записи в этот файл.

Синтаксис

LWSTDAPI SHCreateStreamOnFileW(
  [in]  LPCWSTR pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

Параметры

[in] pszFile

Тип: LPCTSTR

Указатель на строку, завершающую значение NULL, указывающую имя файла.

[in] grfMode

Тип: DWORD

Одно или несколько значений STGM, которые используются для указания режима доступа к файлам и способа создания и удаления объекта, предоставляющего поток.

[out] ppstm

Тип: IStream**

Получает указатель интерфейса IStream для потока, связанного с файлом.

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

Тип: HRESULT

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

Замечания

SHCreateStreamOnFileEx полностью поддерживает все режимы STGM и позволяет вызывающему объекту указывать атрибуты файлов при создании нового файла.

Заметка

Заголовок shlwapi.h определяет SHCreateStreamOnFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

Поделиться через