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 |