Fungsi DdeNameService (ddeml.h)

Artikel
08/23/2023

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
DNS_REGISTER 0x0001	Mendaftarkan nama layanan kode kesalahan.
DNS_UNREGISTER 0x0002	Membatalkan pendaftaran nama layanan kode kesalahan. Jika parameter hsz1 adalah 0L, semua nama layanan yang didaftarkan oleh server akan dibatalkan pendaftarannya.
DNS_FILTERON 0x0004	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 .
DNS_FILTEROFF 0x0008	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