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

已知文件夹示例