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 |