Fungsi SHGetPathFromIDListW (shlobj_core.h)

Mengonversi daftar pengidentifikasi item menjadi jalur sistem file.

Sintaks

BOOL SHGetPathFromIDListW(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPWSTR            pszPath
);

Parameter

[in] pidl

Jenis: PCIDLIST_ABSOLUTE

Alamat daftar pengidentifikasi item yang menentukan file atau lokasi direktori relatif terhadap akar namespace (desktop).

[out] pszPath

Jenis: LPTSTR

Alamat buffer untuk menerima jalur sistem file. Buffer ini harus berukuran setidaknya MAX_PATH karakter.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika berhasil; jika tidak, FALSE.

Keterangan

Jika lokasi yang ditentukan oleh parameter pidl bukan bagian dari sistem file, fungsi ini akan gagal.

Jika parameter pidl menentukan pintasan, pszPath akan berisi jalur ke pintasan, bukan ke target pintasan.

Catatan

Header shlobj_core.h mendefinisikan SHGetPathFromIDList 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 XP [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.0 atau yang lebih baru)
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

SHGetPathFromIDListEx

SHParseDisplayName