Metode IKnownFolder::SetPath (shobjidl_core.h)

Menetapkan jalur baru ke folder yang diketahui.

Sintaks

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

Parameter

[in] dwFlags

Jenis: DWORD

Nol atau nilai berikut:

KF_FLAG_DONT_UNEXPAND

Atur jalur lengkap tanpa string lingkungan. Jika bendera ini tidak diatur, bagian jalur di pszPath dapat diwakili oleh string lingkungan seperti %USERPROFILE%.

[in] pszPath

Jenis: LPCWSTR

Arahkan ke jalur baru folder. Ini adalah string Unicode panjang yang dihentikan null MAX_PATH. Jalur ini tidak boleh memiliki panjang nol. Jika nilai ini NULL, IKnownFolder::SetPath mengatur jalur ke nilai default.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak dapat dipanggil pada folder bertipe KF_CATEGORY_FIXED atau KF_CATEGORY_VIRTUAL.

Untuk memanggil metode ini pada folder jenis KF_CATEGORY_COMMON, aplikasi panggilan harus berjalan dengan hak istimewa yang ditinggikan.

Metode ini setara dengan SHSetKnownFolderPath.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll

Lihat juga

IKnownFolder

Sampel Folder yang Diketahui

SHSetKnownFolderPath