IInitializeWithStream：：Initialize 方法 (propsys.h)

使用流初始化处理程序。

语法

HRESULT Initialize(
  [in] IStream *pstream,
  [in] DWORD   grfMode
);

[in] pstream

类型： IStream*

指向表示流源的 IStream 接口的指针。

[in] grfMode

类型：DWORD

以下 STGM 值之一，指示 pstream 的访问模式。

pstream 指示的流是只读的。

pstream 指示的流是可读/写的。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

此方法优先于 Initialize ，因为它能够使用无法通过 Win32 路径访问的流，例如具有 .zip 文件扩展名的压缩文件的内容。

pstream 指向的流必须在处理程序的生存期内保持打开状态，或者在调用 IPropertyStore：：Commit 之前保持打开状态。

首次打开时，源流引用指向流的开头。处理程序可以随时从流中查找和读取。处理程序可以实现以在 初始化 期间从流中读取所有属性，也可以等到调用进程尝试枚举或读取属性后再从流中提取属性。

处理程序实例在其生存期内应只初始化一次。调用方尝试重新初始化处理程序应导致错误 HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)。