Bagikan melalui

Fungsi SHILCreateFromPath (shlobj_core.h)

  • Artikel

[SHILCreateFromPath tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Aplikasi harus menggunakan SHParseDisplayName sebagai gantinya]

Membuat penunjuk ke daftar pengidentifikasi item (PIDL) dari jalur.

Sintaks

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Parameter

[in] pszPath

Jenis: PCWSTR

Penunjuk ke string panjang maksimum yang dihentikan null MAX_PATH berisi jalur yang akan dikonversi.

[out] ppidl

Jenis: PIDLIST_ABSOLUTE*

Jalur dalam pszPath dinyatakan sebagai PIDL.

[in, out, optional] rgfInOut

Jenis: DWORD*

Penunjuk ke nilai DWORD yang, pada entri, menunjukkan atribut folder bernama dalam pszPath yang ingin diambil aplikasi panggilan bersama dengan PIDL. Saat keluar, nilai ini berisi atribut yang diminta. Untuk daftar bendera atribut yang mungkin untuk parameter ini, lihat IShellFolder::GetAttributesOf.

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 XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlobj_core.h (termasuk Shlobj.h)
Pustaka Shell32.lib
DLL Shell32.dll (versi 5.0 atau yang lebih baru)
Set API ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan dalam Windows 10, versi 10.0.10240)