Bagikan melalui


Fungsi OleUIBusyA (oledlg.h)

Memanggil kotak dialog Sibuk standar, memungkinkan pengguna mengelola konkurensi.

Sintaks

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Parameter

[in] unnamedParam1

Arahkan ke struktur OLEUIBUSY yang berisi informasi yang digunakan untuk menginisialisasi kotak dialog.

Nilai kembali

Fungsi ini mengembalikan nilai berikut:

Definisi Keberhasilan/Kesalahan Standar

Menampilkan kode Deskripsi
OLEUI_FALSE
Kegagalan tidak diketahui (tidak digunakan).
OLEUI_SUCCESS
Tidak ada kesalahan, sama seperti OLEUI_OK.
OLEUI_OK
Pengguna menekan tombol OK .
OLEUI_CANCEL
Pengguna telah menekan tombol Batalkan dan bahwa pemanggil harus membatalkan operasi.
OLEUI_BZ_SWITCHTOSELECTED
Pengguna telah menekan Switch To dan OleUIBusy tidak dapat menentukan cara beralih ke aplikasi pemblokiran. Dalam hal ini, pemanggil harus mengambil langkah-langkah untuk mencoba menyelesaikan konflik itu sendiri, jika memungkinkan, atau mencoba kembali operasi. OleUIBusy hanya akan mengembalikan OLEUI_BZ_SWITCHTOSELECTED jika pengguna telah menekan tombol Beralih Ke , hTask adalah NULL dan bendera BZ_NOTRESPONDING diatur.
OLEUI_BZ_SWITCHTOSELECTED
Pengguna telah menekan Switch To dan OleUIBusy tidak dapat menentukan cara beralih ke aplikasi pemblokiran. Dalam hal ini, pemanggil harus mengambil langkah-langkah untuk mencoba menyelesaikan konflik itu sendiri, jika memungkinkan, atau mencoba kembali operasi. OleUIBusy hanya akan mengembalikan OLEUI_BZ_SWITCHTOSELECTED jika pengguna telah menekan tombol Beralih Ke , hTask adalah NULL dan bendera BZ_NOTRESPONDING diatur.
OLEUI_BZ_SWITCHTOSELECTED
Pengguna telah menekan Switch To dan OleUIBusy tidak dapat menentukan cara beralih ke aplikasi pemblokiran. Dalam hal ini, pemanggil harus mengambil langkah-langkah untuk mencoba menyelesaikan konflik itu sendiri, jika memungkinkan, atau mencoba kembali operasi. OleUIBusy hanya akan mengembalikan OLEUI_BZ_SWITCHTOSELECTED jika pengguna telah menekan tombol Beralih Ke , hTask adalah NULL dan bendera BZ_NOTRESPONDING diatur.
OLEUI_BZ_RETRYSELECTED
Pengguna telah menekan tombol Coba Lagi atau mencoba mengatasi konflik (mungkin dengan beralih ke aplikasi pemblokiran). Dalam hal ini, pemanggil harus mencoba kembali operasi.
OLEUI_BZ_CALLUNBLOCKED
Kotak dialog telah diberitahu bahwa operasi tidak lagi diblokir.
 

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_BZERR_HTASKINVALID
hTask yang ditentukan dalam anggota hTask dari struktur OLEUIBUSY tidak valid.

Keterangan

Kotak dialog OLE Server Sibuk memberi tahu pengguna bahwa aplikasi server tidak menerima pesan. Kotak dialog kemudian meminta pengguna untuk membatalkan operasi, beralih ke tugas yang diblokir, atau melanjutkan menunggu.

Catatan

Header oledlg.h mendefinisikan OLEUIBUSY 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

OLEUIBUSY