IKnownFolderManager::FolderIdToCsidl 方法 (shobjidl_core.h)

获取与给定 KNOWNFOLDERID 等效的旧 CSIDL 值。

语法

HRESULT FolderIdToCsidl(
  [in]  REFKNOWNFOLDERID rfid,
  [out] int              *pnCsidl
);

参数

[in] rfid

类型: REFKNOWNFOLDERID

KNOWNFOLDERID 的引用。

[out] pnCsidl

类型: int*

此方法返回时,包含指向 CSIDL 值的指针。 此指针未初始化传递。

返回值

类型: HRESULT

如果成功,则返回S_OK,否则返回错误值,包括:

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

注解

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

要求

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

另请参阅

IKnownFolderManager

IKnownFolderManager::FolderIdFromCsidl

已知文件夹示例