Fungsi DdeNameService (ddeml.h)
Mendaftarkan atau membatalkan pendaftaran nama layanan yang didukung server Dynamic Data Exchange (DDE). Fungsi ini menyebabkan sistem mengirim XTYP_REGISTER atau XTYP_UNREGISTER transaksi ke aplikasi klien Dynamic Data Exchange Management Library (DDEML) lain yang sedang berjalan.
Sintaks
HDDEDATA DdeNameService(
[in] DWORD idInst,
[in, optional] HSZ hsz1,
[in, optional] HSZ hsz2,
[in] UINT afCmd
);
Parameter
[in] idInst
Jenis: DWORD
Pengidentifikasi instans aplikasi yang diperoleh oleh panggilan sebelumnya ke fungsi DdeInitialize .
[in, optional] hsz1
Jenis: HSZ
Handel ke string yang menentukan nama layanan yang didaftarkan atau tidak terdaftar oleh server. Aplikasi yang membatalkan pendaftaran semua nama layanannya harus mengatur parameter ini ke 0L.
[in, optional] hsz2
Jenis: HSZ
Dipesan; harus diatur ke 0L.
[in] afCmd
Jenis: UINT
Opsi nama layanan. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Mendaftarkan nama layanan kode kesalahan. |
|
Membatalkan pendaftaran nama layanan kode kesalahan. Jika parameter hsz1 adalah 0L, semua nama layanan yang didaftarkan oleh server akan dibatalkan pendaftarannya. |
|
Mengaktifkan pemfilteran inisiasi nama layanan. Filter mencegah server menerima transaksi XTYP_CONNECT untuk nama layanan yang belum terdaftar. Ini adalah pengaturan default untuk filter ini.
Jika aplikasi server tidak mendaftarkan nama layanan apa pun, aplikasi tidak dapat menerima transaksi XTYP_WILDCONNECT . |
|
Menonaktifkan pemfilteran inisiasi nama layanan. Jika bendera ini ditentukan, server menerima transaksi XTYP_CONNECT setiap kali aplikasi DDE lain memanggil fungsi DdeConnect , terlepas dari nama layanan. |
Nilai kembali
Jenis: HDDEDATA
Jika fungsi berhasil, fungsi mengembalikan nilai bukan nol. Nilai itu bukan nilai HDDEDATA sejati, hanyalah indikator keberhasilan Boolean. Fungsi ini dititikkan HDDEDATA untuk memungkinkan kemungkinan perluasan fungsi di masa mendatang dan nilai pengembalian yang lebih canggih.
Jika fungsi gagal, nilai yang dikembalikan adalah 0L.
Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:
Keterangan
Nama layanan yang diidentifikasi oleh parameter hsz1 harus berupa nama dasar (artinya, nama tidak boleh berisi informasi khusus instans). Sistem menghasilkan nama khusus instans dan mengirimkannya bersama dengan nama dasar selama transaksi XTYP_REGISTER dan XTYP_UNREGISTER . Aplikasi penerima kemudian dapat terhubung ke instans aplikasi tertentu.
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 |
Lihat juga
Konseptual
Pustaka Manajemen Pertukaran Data Dinamis
Referensi