Fungsi PathResolve (shlobj_core.h)

Artikel
03/02/2024

[PathResolve tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Mengonversi nama jalur relatif atau tidak memenuhi syarat menjadi nama jalur yang sepenuhnya memenuhi syarat.

Sintaks

int PathResolve(
  [in, out]      PWSTR    pszPath,
  [in, optional] PZPCWSTR dirs,
                 UINT     fFlags
);

Parameter

[in, out] pszPath

Jenis: PWSTR

String Unicode null-terminated yang berisi jalur untuk diselesaikan. Saat fungsi kembali, string berisi jalur yang sepenuhnya memenuhi syarat yang sesuai. Buffer ini setidaknya harus MAX_PATH karakter.

[in, optional] dirs

Jenis: PZPCWSTR

Penunjuk ke array direktori opsional yang dihentikan null untuk dicari terlebih dahulu jika jalur tidak dapat diselesaikan dari pszPath. Nilai ini bisa NULL.

fFlags

Jenis: UINT

Bendera yang menentukan cara fungsi beroperasi.

PRF_VERIFYEXISTS

Mengembalikan TRUE jika keberadaan file diverifikasi; jika tidak FALSE.

PRF_TRYPROGRAMEXTENSIONS

Cari jalur yang ditentukan dengan ekstensi berikut ditambahkan: .pif, .com, .bat, .cmd, .lnk, dan .exe.

PRF_FIRSTDIRDEF

Lihat terlebih dahulu di direktori atau direktori yang ditentukan oleh dirs.

PRF_DONTFINDLNK

Abaikan file .lnk.

PRF_REQUIREABSOLUTE

Memerlukan jalur absolut (penuh).

Nilai kembali

Jenis: int

Mengembalikan TRUE, kecuali PRF_VERIFYEXISTS diatur. Jika bendera tersebut diatur, fungsi mengembalikan TRUE jika file diverifikasi ada dan FALSE sebaliknya. Ini juga mengatur kode kesalahan ERROR_FILE_NOT_FOUND yang dapat Anda ambil dengan memanggil GetLastError.

Keterangan

Nilai pengembalian FALSE tidak selalu berarti bahwa file tidak ada. Ini mungkin berarti bahwa fungsi hanya tidak dapat menemukan file dari informasi yang disediakan.

Jika PathResolve tidak dapat menyelesaikan jalur yang ditentukan dalam pszPath, pathFindOnPath memanggil PathFindOnPath menggunakan pszPath dan dirs sebagai parameter.

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-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

PathFindOnPath

Bagikan melalui