IOpcFactory：：CreateStreamOnFile 方法 (msopc.h)

项目
03/05/2024

通过文件创建流。此方法是用于调用 CreateFile 函数的简化包装器。未通过此方法公开的 CreateFile 参数使用其默认值。有关详细信息，请参阅 CreateFile。

语法

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

参数

[in] filename

创建流的文件的名称。

[in] ioMode

值，该值描述要创建的流的读/写状态。

[in] securityAttributes

有关此参数中 SECURITY_ATTRIBUTES 结构的信息，请参阅 CreateFile 函数。

[in] dwFlagsAndAttributes

文件的设置和属性。对于大多数文件，可以使用 FILE_ATTRIBUTE_NORMAL 。

有关此参数的详细信息，请参阅 CreateFile。

[out, retval] stream

指向流的 IStream 接口的指针。

返回值

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	在 ioMode 参数中传递的值不是有效的OPC_STREAM_IO_MODE枚举值。
E_POINTER	至少有一个文件名和流参数为 NULL。
CreateFile 函数错误	CreateFile 函数中的 HRESULT 错误代码。

注解

当同一流用于反序列化包时，请勿使用流来序列化包数据，因为尝试可能会导致未定义的行为。

有关在加载或保存包时使用此方法的信息，请参阅加载包或保存包编程任务。

对以前 Windows 版本的支持

此方法的行为和性能在所有受支持的 Windows 版本上都是相同的。有关详细信息，请参阅使用打包 API 入门和适用于 Windows Vista 的平台更新。

线程安全性

打包对象不是线程安全的。

有关详细信息，请参阅打包 API 的入门。

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [仅限桌面应用]
目标平台	Windows
标头	msopc.h