Fungsi NetMessageNameAdd (lmmsg.h)

Artikel
08/24/2023

[Fungsi ini tidak didukung pada Windows Vista karena layanan messenger tidak didukung.]

Fungsi NetMessageNameAdd mendaftarkan alias pesan dalam tabel nama pesan. Fungsi ini mengharuskan layanan messenger dimulai.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

Parameter

[in] servername

Arahkan ke string konstanta yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] msgname

Penunjuk ke string konstanta yang menentukan alias pesan untuk ditambahkan. Panjang string tidak boleh lebih dari 15 karakter.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai untuk menyelesaikan operasi.
ERROR_INVALID_PARAMETER	Parameter salah.
ERROR_NOT_SUPPORTED	Permintaan ini tidak didukung. Kesalahan ini dikembalikan pada Windows Vista dan yang lebih baru.
NERR_AlreadyExists	Alias pesan sudah ada pada komputer ini. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
NERR_DuplicateName	Nama yang ditentukan sudah digunakan sebagai alias pesan pada jaringan.
NERR_NetworkError	Kegagalan umum terjadi pada perangkat keras jaringan.
NERR_TooManyNames	Jumlah maksimum alias pesan telah terlampaui.

Keterangan

Hanya anggota grup lokal Administrator yang berhasil menjalankan fungsi NetMessageNameAdd di server jarak jauh.

Bendera tindakan penerusan tidak lagi menjadi parameter untuk LAN Manager 2. xFungsi NetMessageNameAdd karena penerusan pesan tidak lagi didukung. Jika fungsi NetMessageNameAdd mendeteksi bahwa versi msgname yang diteruskan ada di jaringan, fungsi akan gagal dengan kesalahan NERR_Already_Exists.

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	lmmsg.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

Fungsi Pesan

NetMessageNameDel

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan

Bagikan melalui