IKnownFolder：：SetPath 方法 (shobjidl_core.h)

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

语法

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

[in] dwFlags

类型：DWORD

为零或以下值：

设置不带环境字符串的完整路径。如果未设置此标志， 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。