Fungsi ExtractAssociatedIconExA (shellapi.h)

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

Mendapatkan handel ke ikon yang disimpan sebagai sumber daya dalam file atau ikon yang disimpan dalam file yang dapat dieksekusi terkait file. Ini memperluas fungsi ExtractAssociatedIcon dengan mengambil ID ikon ketika ikon tersebut diekstrak dari file yang dapat dieksekusi.

Sintaksis

HICON ExtractAssociatedIconExA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIconIndex,
  [in, out] WORD      *piIconId
);

Parameter

[in] hInst

Jenis: HINSTANCE

Handel modul untuk mengekstrak ikon.

[in, out] pszIconPath

Jenis: LPTSTR

Penunjuk ke string yang, pada entri, menentukan jalur lengkap dan nama file file yang berisi ikon . Fungsi ini mengekstrak handel ikon dari file tersebut, atau dari file yang dapat dieksekusi yang terkait dengan file tersebut.

Ketika fungsi ini kembali, jika handel ikon diperoleh dari file yang dapat dieksekusi (baik file yang dapat dieksekusi langsung ditunjukkan oleh parameter ini atau file yang dapat dieksekusi terkait) fungsi menyimpan jalur lengkap dan nama file yang dapat dieksekusi dalam buffer yang ditunjukkan oleh parameter ini.

[in, out] piIconIndex

Jenis: LPWORD

Penunjuk ke nilai WORD yang, pada entri, menentukan indeks ikon yang handelnya akan diperoleh.

Ketika fungsi kembali, jika handel ikon diperoleh dari file yang dapat dieksekusi (file yang dapat dieksekusi menunjuk ke lpIconPath atau file yang dapat dieksekusi terkait), nilai ini menunjuk ke indeks ikon dalam file tersebut.

[in, out] piIconId

Jenis: LPWORD

Penunjuk ke nilai WORD yang, pada entri, menentukan ID ikon yang handelnya akan diperoleh.

Ketika fungsi kembali, jika handel ikon diperoleh dari file yang dapat dieksekusi (file yang dapat dieksekusi menunjuk ke lpIconPath atau file yang dapat dieksekusi terkait), nilai ini menunjuk ke ID ikon dalam file tersebut.

Mengembalikan nilai

Jenis: HICON

Mengembalikan handel ikon jika berhasil, jika tidak, NULL.

Komentar

Handel ikon yang dikembalikan oleh fungsi ini harus dirilis dengan memanggil DestroyIcon ketika tidak lagi diperlukan.

Nota

Header shellapi.h mendefinisikan ExtractAssociatedIconEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

extractAssociatedIcon

ExtractIcon

ExtractIconEx