Fungsi SHUpdateImageA (shlobj_core.h)

Artikel
03/13/2024

Memberi tahu Shell bahwa gambar dalam daftar gambar sistem telah berubah.

Sintaks

void SHUpdateImageA(
  [in] LPCSTR pszHashItem,
  [in] int    iIndex,
  [in] UINT   uFlags,
  [in] int    iImageIndex
);

Parameter

[in] pszHashItem

Jenis: LPCTSTR

Penunjuk ke nilai string yang menentukan jalur file yang sepenuhnya memenuhi syarat yang berisi ikon. Gunakan jalur yang dikembalikan dalam buffer yang ditunjukkan oleh parameter szIconFile dari IExtractIcon::GetIconLocation.

[in] iIndex

Jenis: int

Bilangan bulat yang menentukan indeks berbasis nol ikon dalam file yang ditentukan oleh pszHashItem. Gunakan nilai yang ditunjukkan oleh parameter piIndex dari IExtractIcon::GetIconLocation.

[in] uFlags

Jenis: UINT

Bilangan bulat yang tidak ditandatangani yang menentukan bendera yang menentukan atribut ikon. Atur uFlags ke nilai yang ditunjukkan oleh parameter pwFlags dari IExtractIcon::GetIconLocation. Bendera yang relevan dengan SHUpdateImageGIL_NOTFILENAME dan GIL_SIMULATEDOC.

[in] iImageIndex

Jenis: int

Bilangan bulat yang menentukan indeks dalam daftar gambar sistem ikon yang sedang diperbarui.

Nilai kembali

Tidak ada

Keterangan

Jika Anda tidak tahu indeks dalam daftar gambar sistem ikon yang ingin Anda perbarui, gunakan SHGetFileInfo dengan parameter uFlags diatur ke SHGFI_SYSICONINDEX.

Anda harus menggunakan IExtractIcon::GetIconLocation dengan parameter ikon lama yang perlu diperbarui, bukan ikon baru yang ingin Anda ganti.

Catatan

Header shlobj_core.h mendefinisikan SHUpdateImage 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 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h, Shlobj_core.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 4.7 atau yang lebih baru)

Lihat juga

SHChangeNotify

Bagikan melalui