Fungsi OleUIConvertA (oledlg.h)
Memanggil kotak dialog Konversi standar, memungkinkan pengguna untuk mengubah jenis objek yang ditentukan tunggal, atau jenis semua objek OLE dari kelas objek yang ditentukan.
Sintaks
UINT OleUIConvertA(
[in] LPOLEUICONVERTA unnamedParam1
);
Parameter
[in] unnamedParam1
Penunjuk ke struktur OLEUICONVERT yang berisi informasi yang digunakan untuk menginisialisasi kotak dialog.
Nilai kembali
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. |
|
Nilai clsid tidak valid. |
|
Nilai dvAspect tidak valid. Anggota ini menentukan aspek objek . |
|
Nilai wFormat tidak valid. Anggota ini menentukan format data objek. |
|
Nilai string (misalnya, lpszUserType atau lpszDefLabel) tidak valid. |
Keterangan
OleUIConvert mengisi kotak daftar Kotak dialog Konversi dengan kelas objek dengan melintasi registri dan mencari entri dalam kunci Yang Dapat Dibaca dan Dapat Dibaca Dapat Ditulis. Setiap kelas yang menyertakan format file default kelas asli dalam kunci yang Dapat Dibaca ditambahkan ke daftar Konversi, dan setiap kelas yang menyertakan format file default kelas asli dalam kunci ReadWritable-nya ditambahkan ke daftar Aktifkan Sebagai. Daftar Konversi diperlihatkan dalam kotak daftar kotak dialog saat tombol radio Konversi dipilih (pilihan default), dan daftar Aktifkan Sebagai diperlihatkan saat Aktifkan Sebagai dipilih.
Perhatikan bahwa Anda dapat mengubah jenis semua objek dari kelas tertentu hanya saat CF_CONVERTONLY tidak ditentukan.
Perintah konversi, yang memanggil fungsi ini, hanya boleh disediakan untuk pengguna jika OleUICanConvertOrActivateAs mengembalikan S_OK.
Catatan
Header oledlg.h mendefinisikan OLEUICONVERT 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 |