IOpcFactory：：CreateStreamOnFile 方法（msopc.h）

项目
11/20/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 Vista 的 Windows 7、带有 SP2 和平台更新的 Windows Vista [仅限桌面应用]
支持的最低服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台	窗户
标头	msopc.h