Fungsi OleUIPromptUserW (oledlg.h)
Menampilkan kotak dialog dengan templat yang ditentukan dan mengembalikan respons (pengidentifikasi tombol) dari pengguna. Fungsi ini digunakan untuk menampilkan pesan peringatan OLE, misalnya, Kelas Tidak Terdaftar.
Sintaks
int OleUIPromptUserW(
[in] int nTemplate,
[in] HWND hwndParent,
...
);
Parameter
[in] nTemplate
Nomor sumber daya kotak dialog yang akan ditampilkan. Lihat Keterangan.
[in] hwndParent
Handel ke jendela induk kotak dialog.
...
Opsional. Judul kotak dialog diikuti dengan daftar argumen untuk string format dalam kontrol statis (IDC_PU_TEXT) kotak dialog. Penelepon harus memastikan untuk meneruskan nomor dan jenis argumen yang benar.
Mengembalikan nilai
Definisi Keberhasilan/Kesalahan Standar
Menampilkan kode | Deskripsi |
---|---|
|
Kegagalan tidak diketahui (tidak digunakan). |
|
Pengguna menekan tombol OK . |
|
Tidak ada kesalahan, sama seperti OLEUI_OK. |
|
Pengguna menekan tombol Batalkan . |
Kesalahan Validasi Bidang Standar
Menampilkan kode | Deskripsi |
---|---|
|
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. |
|
Penunjuk ke struktur OLEUIXXX yang diteruskan ke fungsi adalah NULL. |
|
Izin untuk akses baca atau tulis ke struktur OLEUIXXX tidak cukup. |
|
Nilai cbstruct salah. |
|
Nilai hWndOwner tidak valid. |
|
Nilai lpszCaption tidak valid. |
|
Nilai lpfnHook tidak valid. |
|
Nilai hInstance tidak valid. |
|
Nilai lpszTemplate tidak valid. |
|
Nilai hResource tidak valid. |
Kesalahan Inisialisasi
Menampilkan kode | Deskripsi |
---|---|
|
Tidak dapat menemukan templat kotak dialog. |
|
Tidak dapat memuat templat kotak dialog. |
|
Inisialisasi kotak dialog gagal. |
|
Panggilan ke LocalAlloc atau alokator IMalloc standar gagal. |
|
Panggilan ke GlobalAlloc atau alokator IMalloc standar gagal. |
|
Tidak dapat memanggil LoadString untuk sumber daya yang dilokalkan dari pustaka. |
|
Panggilan ke alokator IMalloc standar gagal. |
Kesalahan Spesifik Fungsi
Menampilkan kode | Deskripsi |
---|---|
|
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. |
Keterangan
Templat kotak dialog berikut ini ditentukan dalam Panduan Antarmuka Windows--Panduan untuk Merancang Perangkat Lunak. Parameter nTemplate harus menjadi sumber daya yang saat ini ditentukan, namun, templat tambahan dapat ditambahkan ke prompt.dlg.
IDD_LINKSOURCEUNAVAILABLE
IDD_CANNOTUPDATELINK
IDD_SERVERNOTREG
IDD_CANNOTRESPONDVERB
IDD_SERVERNOTFOUND
Catatan
Header oledlg.h mendefinisikan OleUIPromptUser 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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk