Fungsi NetMessageNameGetInfo (lmmsg.h)

Artikel
08/24/2023

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

Fungsi NetMessageNameGetInfo mengambil informasi tentang alias pesan tertentu dalam tabel nama pesan. Fungsi ini mengharuskan layanan messenger dimulai.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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

Arahkan ke string konstanta yang menentukan alias pesan untuk mengembalikan informasi.

[in] level

Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Mengembalikan alias pesan. Parameter bufptr menunjuk ke struktur MSG_INFO_0 .
1	Mengembalikan alias pesan. Parameter bufptr menunjuk ke struktur MSG_INFO_1 . Tingkat ini hanya ada untuk kompatibilitas. Penerusan pesan tidak didukung.

[out] bufptr

Arahkan ke buffer yang menerima data. Format data ini tergantung pada nilai parameter tingkat . Buffer ini dialokasikan oleh sistem dan harus dikosongkan menggunakan fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

Menampilkan nilai

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_LEVEL	Nilai yang ditentukan untuk parameter tingkat tidak valid.
ERROR_INVALID_PARAMETER	Parameter salah.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia.
ERROR_NOT_SUPPORTED	Permintaan ini tidak didukung. Kesalahan ini dikembalikan pada Windows Vista dan yang lebih baru.
NERR_NotLocalName	Alias pesan tidak ada di komputer lokal.

Keterangan

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

Untuk mencantumkan semua alias pesan dalam tabel nama pesan, Anda bisa memanggil fungsi NetMessageNameEnum .

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