IPersistFolder::Initialize 方法 (shobjidl_core.h)
指示 Shell 文件夹对象根据传递的信息初始化自身。
语法
HRESULT Initialize(
PCIDLIST_ABSOLUTE pidl
);
参数
pidl
类型: LPCITEMIDLIST
ITEMIDLIST (项标识符列表的地址) 结构,用于指定文件夹的绝对位置。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
实现要在 Shell 命名空间中使用的 IShellFolder 接口的所有对象都必须实现此方法。 当文件夹在命名空间中的位置不是相关的考虑因素时,此方法只需返回S_OK。 当位置与文件夹相关时,应存储传入的完全限定 IDLIST,供以后参考。
例如,如果文件夹实现需要构造指向项标识符列表的完全限定指针, (PIDL) 到它所包含的元素,则传递给此方法的 PIDL 应用于构造完全限定的 PIDL。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
DLL | Shell32.dll (4.0 或更高版本) |