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

資料夾新路徑的指標。 這是長度為 null 的 Unicode 字串MAX_PATH。 此路徑不能為零長度。 如果此值為 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