Fungsi ExtractIconExA (shellapi.h)

Fungsi ExtractIconEx membuat array handel ke ikon besar atau kecil yang diekstrak dari file yang dapat dieksekusi, DLL, atau file ikon yang ditentukan.

Syntax

UINT ExtractIconExA(
  [in]  LPCSTR lpszFile,
  [in]  int    nIconIndex,
  [out] HICON  *phiconLarge,
  [out] HICON  *phiconSmall,
        UINT   nIcons
);

Parameter-parameternya

[in] lpszFile

Jenis: LPCTSTR

Penunjuk ke string null-terminated yang menentukan nama file yang dapat dieksekusi, DLL, atau file ikon tempat ikon akan diekstrak.

[in] nIconIndex

Jenis: int

Menentukan indeks berbasis nol dari ikon pertama yang akan diekstrak. Misalnya, jika nilai ini nol, fungsi mengekstrak ikon pertama dalam file yang ditentukan.

Jika nilai ini adalah –1 dan phiconLarge dan phiconSmall keduanya NULL, fungsi mengembalikan jumlah total ikon dalam file yang ditentukan. Jika file adalah file yang dapat dieksekusi atau DLL, nilai yang dikembalikan adalah jumlah sumber daya RT_GROUP_ICON. Jika file adalah file .ico, nilai yang dikembalikan adalah 1.

Jika nilai ini adalah angka negatif dan phiconLarge atau phiconSmall bukan NULL, fungsi dimulai dengan mengekstrak ikon yang pengidentifikasi sumber dayanya sama dengan nilai absolut nIconIndex. Misalnya, gunakan -3 untuk mengekstrak ikon yang pengidentifikasi sumber dayanya adalah 3.

[out] phiconLarge

Jenis: HICON*

Penunjuk ke array handel ikon yang menerima handel ke ikon besar yang diekstrak dari file. Jika parameter ini NULL, tidak ada ikon besar yang diekstrak dari file.

[out] phiconSmall

Jenis: HICON*

Penunjuk ke array handel ikon yang menerima handel ke ikon kecil yang diekstrak dari file. Jika parameter ini NULL, tidak ada ikon kecil yang diekstrak dari file.

nIcons

Jenis: UINT

Jumlah ikon yang akan diekstrak dari file.

Mengembalikan nilai

Jenis: UINT

Jika parameter nIconIndex -1 dan parameter phiconLarge dan phiconSmall adalah NULL, maka nilai yang dikembalikan adalah jumlah ikon yang terkandung dalam file yang ditentukan.

Jika parameter nIconIndex adalah nilai apa pun selain -1 dan phiconLarge atau phiconSmall bukan NULL, nilai yang dikembalikan adalah jumlah ikon yang berhasil diekstraksi dari file.

Nota

Jika fungsi mengalami kesalahan, fungsi akan mengembalikan UINT_MAX. Dalam hal ini, Anda dapat memanggil GetLastError untuk mengambil kode kesalahan. Misalnya, fungsi ini mengembalikan UINT_MAX jika file yang ditentukan oleh lpszFile tidak dapat ditemukan sementara parameter nIconIndex adalah nilai apa pun selain -1 dan phiconLarge atau phiconSmall bukan NULL. Dalam hal ini, GetLastError mengembalikan ERROR_FILE_NOT_FOUND (2).

Komentar

Ketika tidak lagi diperlukan, Anda harus menghancurkan semua ikon yang diekstrak oleh ExtractIconEx dengan memanggil fungsi DestroyIcon .

Untuk mengambil dimensi ikon besar dan kecil, gunakan fungsi ini dengan bendera SM_CXICON, SM_CYICON, SM_CXSMICON, dan SM_CYSMICON.

Nota

Header shellapi.h mendefinisikan ExtractIconEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Library	shell32.lib
DLL	Shell32.dll
Set API	ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan di Windows 10, versi 10.0.10240)

Lihat juga

ExtractAssociatedIcon

ExtractAssociatedIconEx

ExtractIcon