Fungsi SHGetSpecialFolderLocation (shlobj_core.h)

Artikel
03/04/2024

[SHGetSpecialFolderLocation tidak didukung dan dapat diubah atau tidak tersedia di masa mendatang. Sebagai gantinya, gunakan SHGetFolderLocation.]

Mengambil penunjuk ke struktur ITEMIDLIST dari folder khusus.

Sintaks

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parameter

[in] hwnd

Jenis: HWND

Dicadangkan.

[in] csidl

Jenis: int

Nilai CSIDL yang mengidentifikasi folder yang diminati.

[out] ppidl

Jenis: PIDLIST_ABSOLUTE*

PIDL yang menentukan lokasi folder relatif terhadap akar namespace (desktop). Adalah tanggung jawab aplikasi panggilan untuk membebaskan IDList yang dikembalikan dengan menggunakan CoTaskMemFree.

Nilai kembali

Jenis: HRESULT

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)
Set API	ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

SHGetSpecialFolderPath

Bagikan melalui