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,否则返回错误值,包括以下内容:
返回代码 | 说明 |
---|---|
|
除其他事项外,此值可以指示 该参数 引用系统上不存在的 KNOWNFOLDERID 。 并非所有 KNOWNFOLDERID 值都存在于所有系统上。 使用 IKnownFolderManager::GetFolderIds 检索当前系统的 KNOWNFOLDERID 值集。 |
注解
若要调用此方法,调用方必须至少具有用户权限。
何时使用
当您确切知道要查找的已知文件夹并希望直接访问它时,请使用此方法。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
DLL | Shell32.dll |