Fungsi SHGetSpecialFolderPathA (shlobj_core.h)

Artikel
03/15/2023

[SHGetSpecialFolderPath tidak didukung. Sebagai gantinya, gunakan SHGetFolderPath.]

Mengambil jalur folder khusus, yang diidentifikasi oleh CSIDL-nya.

Sintaks

BOOL SHGetSpecialFolderPathA(
        HWND  hwnd,
  [out] LPSTR pszPath,
  [in]  int   csidl,
  [in]  BOOL  fCreate
);

Parameter

hwnd

Jenis: HWND

Dicadangkan.

[out] pszPath

Jenis: LPTSTR

Penunjuk ke string yang dihentikan null yang menerima drive dan jalur folder yang ditentukan. Buffer ini setidaknya harus berukuran MAX_PATH karakter.

[in] csidl

Jenis: int

CSIDL yang mengidentifikasi folder yang menarik. Jika folder virtual ditentukan, fungsi ini akan gagal.

[in] fCreate

Jenis: BOOL

Menunjukkan apakah folder harus dibuat jika belum ada. Jika nilai ini bukan nol, folder akan dibuat. Jika nilai ini nol, folder tidak dibuat.

Nilai kembali

Jenis: BOOL

TRUE jika berhasil; jika tidak, FALSE.

Keterangan

Pembaruan Desktop Microsoft Internet Explorer 4.0 harus diinstal agar fungsi ini tersedia.

Catatan

Header shlobj_core.h mendefinisikan SHGetSpecialFolderPath sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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, Shlobj_core.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui