IKnownFolderManager::FindFolderFromPath 方法 (shobjidl_core.h)

获取一个 对象,该对象表示基于文件系统路径的已知文件夹。 对象允许查询某些文件夹属性、获取文件夹的当前路径、将文件夹重定向到另一个位置,以及获取 作为 ITEMIDLIST 的文件夹路径。

语法

HRESULT FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

参数

[in] pszPath

类型: LPCWSTR

指向长度为 null 的 Unicode 字符串的指针MAX_PATH,其中包含已知文件夹的路径。

[in] mode

类型: FFFP_MODE

以下值之一,用于指定路径和已知文件夹的匹配精度:

FFFP_EXACTMATCH

仅检索给定文件路径的特定已知文件夹。

FFFP_NEARESTPARENTMATCH

如果未找到给定文件路径的完全匹配项,请检索与父树中某个父文件夹匹配的第一个已知文件夹。

[out] ppkf

类型: IKnownFolder**

此方法返回时,包含指向表示已知文件夹的 IKnownFolder 对象的指针的地址。

返回值

类型: HRESULT

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

要求

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

另请参阅

IKnownFolderManager

已知文件夹示例