Metode IAssocHandler::GetIconLocation (shobjidl_core.h)

Mengambil lokasi ikon yang terkait dengan aplikasi.

Sintaks

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

Parameter

[out] ppszPath

Jenis: LPWSTR*

Ketika metode ini kembali, berisi alamat penunjuk ke string Unicode yang dihentikan null yang berisi jalur ke ikon aplikasi.

[out] pIndex

Jenis: int*

Ketika metode ini kembali, berisi penunjuk ke indeks ikon dalam sumber daya bernama di ppszPath.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika ikon tidak dapat ditemukan, fungsi akan mengembalikan jalur ke yang dapat dieksekusi, dan indeks ikon nol.

Untuk alasan performa, aplikasi dapat menggunakan cache gambar Shell untuk mengambil ikon, daripada memuat ikon langsung dari jalur yang dikembalikan. Jalur dan indeks ikon dapat diteruskan langsung ke Shell_GetCachedImageIndex. Salah satu manfaatnya adalah bahwa cache Shell dapat menyediakan ikon default jika tidak ada ikon yang tersedia untuk aplikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)