IKnownFolder：：SetPath 方法 (shobjidl_core.h)

指派已知資料夾的新路徑。

語法

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

[in] dwFlags

類型： DWORD

零或下列值：

設定不含環境字串的完整路徑。如果未設定此旗標， pszPath 上的路徑部分可能會以環境字串表示，例如 %USERPROFILE%。

[in] pszPath

類型： LPCWSTR

資料夾新路徑的指標。這是長度為 null 的 Unicode 字串MAX_PATH。此路徑不能為零長度。如果此值為 NULL，IKnownFolder：：SetPath 會將路徑設定為預設值。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

無法在類型為 KF_CATEGORY_FIXED 或 KF_CATEGORY_VIRTUAL 的資料夾上呼叫此方法。

若要在類型為 KF_CATEGORY_COMMON 的資料夾上呼叫這個方法，呼叫端應用程式必須以較高的許可權執行。

這個方法相當於 SHSetKnownFolderPath。