SHCreateStreamOnFileA 函数（shlwapi.h）

[SHCreateStreamOnFile 可用于“要求”部分中指定的操作系统。在后续版本中可能会更改或不可用。请改用 SHCreateStreamOnFileEx.]

打开或创建一个文件，并检索要读取或写入该文件的流。

语法

LWSTDAPI SHCreateStreamOnFileA(
  [in]  LPCSTR  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 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。