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 或更高版本)