IInitializeWithStream::Initialize 方法 (propsys.h)

使用流初始化处理程序。

语法

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

参数

[in] pstream

类型: IStream*

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

[in] grfMode

类型:DWORD

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

STGM_READ

pstream 指示的流是只读的。

STGM_READWRITE

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

返回值

类型: HRESULT

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

注解

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

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

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

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 propsys.h