Metode IShellLinkA::GetPath (shobjidl_core.h)

  • Artikel

Mendapatkan jalur dan nama file dari target objek tautan Shell.

Sintaks

HRESULT GetPath(
  [out]     LPSTR            pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAA *pfd,
  [in]      DWORD            fFlags
);

Parameter

[out] pszFile

Jenis: LPTSTR

Alamat buffer yang menerima jalur dan nama file target objek tautan Shell.

[in] cch

Jenis: int

Ukuran, dalam karakter, dari buffer yang diacu oleh parameter pszFile , termasuk karakter null yang mengakhiri. Ukuran jalur maksimum yang dapat dikembalikan adalah MAX_PATH. Parameter ini biasanya diatur dengan memanggil ARRAYSIZE(pszFile). Makro ARRAYSIZE didefinisikan dalam Winnt.h.

[in, out] pfd

Jenis: WIN32_FIND_DATA*

Penunjuk ke struktur WIN32_FIND_DATA yang menerima informasi tentang target objek tautan Shell. Jika parameter ini NULL, maka tidak ada informasi tambahan yang dikembalikan.

[in] fFlags

Jenis: DWORD

Bendera yang menentukan jenis informasi jalur yang akan diambil. Parameter ini bisa menjadi kombinasi dari nilai berikut.

SLGP_SHORTPATH

Mengambil nama file pendek standar (format 8.3).

SLGP_UNCPRIORITY

Tidak didukung; jangan gunakan.

SLGP_RAWPATH

Mengambil nama jalur mentah. Jalur mentah adalah sesuatu yang mungkin tidak ada dan mungkin mencakup variabel lingkungan yang perlu diperluas.

SLGP_RELATIVEPRIORITY

Windows Vista dan yang lebih baru. Mengambil jalur, jika memungkinkan, dari target pintasan relatif terhadap jalur yang ditetapkan oleh panggilan sebelumnya ke IShellLink::SetRelativePath.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika operasi berhasil dan jalur yang valid diambil. Jika operasi berhasil tetapi tidak ada jalur yang diambil, maka akan mengembalikan S_FALSE dan pszFile akan kosong. Jika tidak, ia mengembalikan salah satu nilai kesalahan HRESULT standar.

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 shobjidl_core.h
DLL Shell32.dll (versi 4.0 atau yang lebih baru)