IKnownFolderManager::GetFolderIds 方法 (shobjidl_core.h)

获取所有已注册的已知文件夹 ID 的数组。 这可用于枚举所有已知文件夹。

语法

HRESULT GetFolderIds(
  [out]     KNOWNFOLDERID **ppKFId,
  [in, out] UINT          *pCount
);

参数

[out] ppKFId

类型: KNOWNFOLDERID**

此方法返回时,包含指向向系统注册的所有 KNOWNFOLDERID 值的数组的指针。 当不再需要这些资源时,请使用 CoTaskMemFree 释放这些资源。

[in, out] pCount

类型: UINT*

此方法返回时,包含指向数组中 ppKFId 中的 KNOWNFOLDERID 值数的指针。 不使用此参数的 [in] 功能。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法的调用方必须具有“用户”权限。

可以使用 StringFromCLSIDStringFromGUID2 将检索到的 KNOWNFOLDERID 值转换为字符串。

要求

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

另请参阅

IKnownFolderManager

已知文件夹示例