Fungsi ExtractAssociatedIconExA (shellapi.h)

Artikel
08/26/2023

[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 file yang dapat dieksekusi terkait. Ini memperluas fungsi ExtractAssociatedIcon dengan mengambil ID ikon ketika ikon tersebut diekstraksi dari file yang dapat dieksekusi.

Sintaks

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 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 diarahkan oleh parameter ini atau file yang dapat dieksekusi terkait) fungsi menyimpan jalur lengkap dan nama file yang dapat dieksekusi dalam buffer yang diarahkan 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 (baik file yang dapat dieksekusi yang ditunjukkan oleh 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.

Menampilkan nilai

Jenis: HICON

Mengembalikan handel ikon jika berhasil, jika tidak , NULL.

Keterangan

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

Catatan

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

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	shellapi.h
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx

Bagikan melalui