Fungsi panggilan balik PFNCALLBACK (ddeml.h)
Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan fungsi Dynamic Data Exchange Management Library (DDEML). Ini memproses transaksi Dynamic Data Exchange (DDE). Jenis PFNCALLBACK mendefinisikan penunjuk ke fungsi panggilan balik ini. DdeCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
PFNCALLBACK Pfncallback;
HDDEDATA Pfncallback(
[in] UINT wType,
[in] UINT wFmt,
[in] HCONV hConv,
[in] HSZ hsz1,
[in] HSZ hsz2,
[in] HDDEDATA hData,
[in] ULONG_PTR dwData1,
[in] ULONG_PTR dwData2
)
{...}
Parameter
[in] wType
Jenis: UINT
Jenis transaksi saat ini. Parameter ini terdiri dari kombinasi bendera kelas transaksi dan bendera jenis transaksi. Tabel berikut menjelaskan setiap kelas transaksi dan menyediakan daftar jenis transaksi di setiap kelas. Untuk informasi tentang jenis transaksi tertentu, lihat deskripsi individual dari jenis tersebut di Keterangan.
[in] wFmt
Jenis: UINT
Format di mana data dikirim atau diterima.
[in] hConv
Jenis: HCONV
Handel ke percakapan yang terkait dengan transaksi saat ini.
[in] hsz1
Jenis: HSZ
Handel ke string. Arti dari parameter ini tergantung pada jenis transaksi saat ini. Untuk arti parameter ini, lihat deskripsi jenis transaksi dalam Keterangan.
[in] hsz2
Jenis: HSZ
Handel ke string. Arti dari parameter ini tergantung pada jenis transaksi saat ini. Untuk arti parameter ini, lihat deskripsi jenis transaksi dalam Keterangan.
[in] hData
Jenis: HDDEDATA
Handel ke data DDE. Arti dari parameter ini tergantung pada jenis transaksi saat ini. Untuk arti parameter ini, lihat deskripsi jenis transaksi dalam Keterangan.
[in] dwData1
Jenis: ULONG_PTR
Data khusus transaksi. Untuk arti parameter ini, lihat deskripsi jenis transaksi dalam Keterangan.
[in] dwData2
Jenis: ULONG_PTR
Data khusus transaksi. Untuk arti parameter ini, lihat deskripsi jenis transaksi dalam Keterangan.
Nilai kembali
Jenis: HDDEDATA
Nilai yang dikembalikan tergantung pada kelas transaksi. Untuk informasi selengkapnya tentang nilai pengembalian, lihat deskripsi jenis transaksi individual.
Keterangan
XCLASS_BOOL
Fungsi panggilan balik DDE harus mengembalikan TRUE atau FALSE ketika selesai memproses transaksi yang termasuk dalam kelas ini. Kelas transaksi XCLASS_BOOL terdiri dari jenis berikut:
XCLASS_DATA
Fungsi panggilan balik DDE harus mengembalikan handel DDE, CBR_BLOCK mengembalikan kode, atau NULL ketika selesai memproses transaksi milik kelas ini. Kelas transaksi XCLASS_DATA terdiri dari jenis berikut:
XCLASS_FLAGS
Fungsi panggilan balik DDE harus mengembalikan DDE_FACK, DDE_FBUSY, atau DDE_FNOTPROCESSED ketika selesai memproses transaksi milik kelas ini. Kelas transaksi XCLASS_FLAGS terdiri dari jenis berikut:
XCLASS_NOTIFICATION
Jenis transaksi yang termasuk dalam kelas ini hanya untuk tujuan pemberitahuan. Nilai yang dikembalikan dari fungsi panggilan balik diabaikan. Kelas transaksi XCLASS_NOTIFICATION terdiri dari jenis berikut:
- XTYP_ADVSTOP
- XTYP_CONNECT_CONFIRM
- XTYP_DISCONNECT
- XTYP_ERROR
- XTYP_MONITOR
- XTYP_REGISTER
- XTYP_XACT_COMPLETE
- XTYP_UNREGISTER
Fungsi panggilan balik dipanggil secara asinkron untuk transaksi yang tidak melibatkan pembuatan atau penghentian percakapan. Aplikasi yang tidak sering menerima pesan masuk akan mengurangi performa DDE karena Dynamic Data Exchange Management Library (DDEML) menggunakan pesan untuk memulai transaksi.
Aplikasi harus mendaftarkan fungsi panggilan balik dengan menentukan penunjuk ke fungsi dalam panggilan ke fungsi DdeInitialize .
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) |
Lihat juga
Konseptual