IKnownFolder：：SetPath 方法 (shobjidl_core.h)

  • 项目

为已知文件夹分配新路径。

语法

HRESULT SetPath(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszPath
);

参数

[in] dwFlags

类型：DWORD

为零或以下值：

KF_FLAG_DONT_UNEXPAND

设置不带环境字符串的完整路径。 如果未设置此标志， pszPath 中的路径部分可能由环境字符串（如 %USERPROFILE%）表示。

[in] pszPath

类型： LPCWSTR

指向文件夹的新路径的指针。 这是长度为 MAX_PATH 的以 null 结尾的 Unicode 字符串。 此路径的长度不能为零。 如果此值为 NULL， 则 IKnownFolder：：SetPath 会将路径设置为默认值。

返回值

类型： HRESULT

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

注解

无法在 类型为 KF_CATEGORY_FIXED 或 KF_CATEGORY_VIRTUAL 的文件夹上调用此方法。

若要在 KF_CATEGORY_COMMON 类型的文件夹上调用此方法，调用应用程序必须以提升的权限运行。

此方法等效于 SHSetKnownFolderPath。

要求

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

另请参阅

IKnownFolder

已知文件夹示例

SHSetKnownFolderPath