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

  • Статья

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

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

Синтаксис

LWSTDAPI SHCreateStreamOnFileA(
  [in]  LPCSTR  pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

Параметры

[in] pszFile

Тип: LPCTSTR

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

[in] grfMode

Тип: DWORD

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

[out] ppstm

Тип: IStream**

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

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

Тип: HRESULT

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

Комментарии

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

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.0 или более поздняя)