Fungsi DdeEnableCallback (ddeml.h)

Artikel
08/23/2023

Mengaktifkan atau menonaktifkan transaksi untuk percakapan tertentu atau untuk semua percakapan yang saat ini dibuat oleh aplikasi panggilan.

Sintaks

BOOL DdeEnableCallback(
  [in] DWORD idInst,
  [in] HCONV hConv,
  [in] UINT  wCmd
);

Parameter

[in] idInst

Jenis: DWORD

Pengidentifikasi instans aplikasi yang diperoleh oleh panggilan sebelumnya ke fungsi DdeInitialize .

[in] hConv

Jenis: HCONV

Handel ke percakapan untuk mengaktifkan atau menonaktifkan. Jika parameter ini NULL, fungsi akan memengaruhi semua percakapan.

[in] wCmd

Jenis: UINT

Kode fungsi. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
EC_ENABLEALL 0	Mengaktifkan semua transaksi untuk percakapan yang ditentukan.
EC_ENABLEONE 0x0080	Mengaktifkan satu transaksi untuk percakapan yang ditentukan.
EC_DISABLE 0x0008	Menonaktifkan semua transaksi yang dapat diblokir untuk percakapan yang ditentukan. Aplikasi server dapat menonaktifkan transaksi berikut: XTYP_ADVSTART XTYP_ADVSTOP XTYP_EXECUTE XTYP_POKE XTYP_REQUEST Aplikasi klien dapat menonaktifkan transaksi berikut: XTYP_ADVDATA XTYP_XACT_COMPLETE
EC_QUERYWAITING 2	Menentukan apakah ada transaksi dalam antrean untuk percakapan yang ditentukan.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Jika parameter wCmdEC_QUERYWAITING, dan antrean transaksi aplikasi berisi satu atau beberapa transaksi yang tidak diproses yang tidak diproses, nilai yang dikembalikan adalah TRUE; jika tidak, itu adalah FALSE.

Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:

Keterangan

Aplikasi dapat menonaktifkan transaksi untuk percakapan tertentu dengan mengembalikan kode pengembalian CBR_BLOCK dari fungsi panggilan balik Dynamic Data Exchange (DDE). Saat Anda mengaktifkan kembali percakapan dengan menggunakan fungsi DdeEnableCallback , sistem operasi menghasilkan transaksi yang sama yang sedang dalam proses ketika percakapan dinonaktifkan.

Menggunakan bendera EC_QUERYWAITING tidak mengubah status aktifkan percakapan dan tidak menyebabkan transaksi dikeluarkan dalam konteks panggilan ke DdeEnableCallback.

Jika DdeEnableCallback dipanggil dengan EC_QUERYWAITING dan fungsi mengembalikan bukan nol, aplikasi harus mencoba dengan cepat mengizinkan pemrosesan pesan, kembali dari panggilan baliknya, atau mengaktifkan panggilan balik. Hasil seperti itu tidak menjamin bahwa panggilan balik berikutnya akan dilakukan. Memanggil DdeEnableCallback dengan EC_QUERYWAITING memungkinkan aplikasi dengan panggilan balik yang diblokir menentukan apakah ada transaksi yang tertunda pada percakapan yang diblokir. Tentu saja, bahkan jika panggilan seperti itu mengembalikan nol, aplikasi harus selalu memproses pesan secara tepat waktu.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ddeml.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll