Fungsi OleUIChangeIconA (oledlg.h)

Artikel
03/15/2023

Memanggil kotak dialog Ubah Ikon standar, yang memungkinkan pengguna untuk memilih ikon dari file ikon, dapat dieksekusi, atau DLL.

Sintaks

UINT OleUIChangeIconA(
  [in] LPOLEUICHANGEICONA unnamedParam1
);

Parameter

[in] unnamedParam1

Arahkan ke struktur OLEUICHANGEICON Masuk/Keluar untuk kotak dialog ini.

Nilai kembali

Definisi Keberhasilan/Kesalahan Standar

Menampilkan kode	Deskripsi
OLEUI_FALSE	Kegagalan tidak diketahui (tidak digunakan).
OLEUI_OK	Pengguna menekan tombol OK.
OLEUI_SUCCESS	Tidak ada kesalahan, sama seperti OLEUI_OK.
OLEUI_CANCEL	Pengguna menekan tombol Batalkan.

Kesalahan Validasi Bidang Standar

Menampilkan kode	Deskripsi
OLEUI_ERR_STANDARDMIN	Kesalahan umum untuk semua kotak dialog terletak di rentang OLEUI_ERR_STANDARDMIN untuk OLEUI_ERR_STANDARDMAX. Nilai ini memungkinkan aplikasi untuk menguji pesan standar untuk menampilkan pesan kesalahan kepada pengguna.
OLEUI_ERR_STRUCTURENULL	Penunjuk ke struktur OLEUIXXX yang diteruskan ke fungsi adalah NULL.
OLEUI_ERR_STRUCTUREINVALID	Izin untuk akses baca atau tulis ke struktur OLEUIXXX tidak cukup.
OLEUI_ERR_CBSTRUCTINCORRECT	Nilai cbstruct salah.
OLEUI_ERR_HWNDOWNERINVALID	Nilai hWndOwner tidak valid.
OLEUI_ERR_LPSZCAPTIONINVALID	Nilai lpszCaption tidak valid.
OLEUI_ERR_LPFNHOOKINVALID	Nilai lpfnHook tidak valid.
OLEUI_ERR_HINSTANCEINVALID	Nilai hInstance tidak valid.
OLEUI_ERR_LPSZTEMPLATEINVALID	Nilai lpszTemplate tidak valid.
OLEUI_ERR_HRESOURCEINVALID	Nilai hResource tidak valid.

Kesalahan Inisialisasi

Menampilkan kode	Deskripsi
OLEUI_ERR_FINDTEMPLATEFAILURE	Tidak dapat menemukan templat kotak dialog.
OLEUI_ERR_LOADTEMPLATEFAILURE	Tidak dapat memuat templat kotak dialog.
OLEUI_ERR_DIALOGFAILURE	Inisialisasi kotak dialog gagal.
OLEUI_ERR_LOCALMEMALLOC	Panggilan ke LocalAlloc atau alokator IMalloc standar gagal.
OLEUI_ERR_GLOBALMEMALLOC	Panggilan ke GlobalAlloc atau alokator IMalloc standar gagal.
OLEUI_ERR_LOADSTRING	Tidak dapat memanggil LoadString untuk sumber daya yang dilokalkan dari pustaka.
OLEUI_ERR_OLEMEMALLOC	Panggilan ke alokator IMalloc standar gagal.

Kesalahan Spesifik Fungsi

Menampilkan kode	Deskripsi
OLEUI_ERR_STANDARDMAX	Kesalahan umum untuk semua kotak dialog terletak di rentang OLEUI_ERR_STANDARDMIN untuk OLEUI_ERR_STANDARDMAX. Nilai ini memungkinkan aplikasi untuk menguji pesan standar untuk menampilkan pesan kesalahan kepada pengguna.
OLEUI_CIERR_MUSTHAVECLSID	Anggota clsid bukan CLSID saat ini.
OLEUI_CIERR_MUSTHAVECURRENTMETAFILE	Anggota hMetaPict bukan metafile saat ini.
OLEUI_CIERR_SZICONEXEINVALID	Nilai szIconExe tidak valid.

Keterangan

Struktur OLEUICHANGEICON .

Catatan

Header oledlg.h mendefinisikan OLEUICHANGEICON 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 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oledlg.h
Pustaka	OleDlg.lib
DLL	OleDlg.dll

Lihat juga

OLEUICHANGEICON

Bagikan melalui