IKnownFolderManager：：GetFolder 方法 (shobjidl_core.h)

  • 项目

获取一个 对象，该对象表示由其 KNOWNFOLDERID 标识的已知文件夹。 对象允许查询某些文件夹属性、获取文件夹的当前路径、将文件夹重定向到另一个位置，以及获取 作为 ITEMIDLIST 的文件夹路径。

语法

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

参数

[in] rfid

类型： REFKNOWNFOLDERID

对 KNOWNFOLDERID 的引用。

[out] ppkf

类型： IKnownFolder**

此方法返回时，包含指向表示文件夹的 IKnownFolder 对象的接口指针。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值，包括以下内容：

返回代码 说明
E_INVALIDARG
 除其他事项外，此值可以指示 该参数 引用系统上不存在的 KNOWNFOLDERID 。 并非所有 KNOWNFOLDERID 值都存在于所有系统上。 使用 IKnownFolderManager：：GetFolderIds 检索当前系统的 KNOWNFOLDERID 值集。

注解

若要调用此方法，调用方必须至少具有用户权限。

何时使用

当您确切知道要查找的已知文件夹并希望直接访问它时，请使用此方法。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll

另请参阅

IKnownFolderManager

已知文件夹示例