Bagikan melalui


Fungsi NetMessageBufferSend (lmmsg.h)

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

Fungsi NetMessageBufferSend mengirimkan buffer informasi ke alias pesan terdaftar.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

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 tempat buffer pesan harus dikirim.

[in] fromname

Penunjuk ke string konstanta yang menentukan dari siapa pesan tersebut berasal. Jika parameter ini NULL, pesan dikirim dari nama komputer lokal.

[in] buf

Penunjuk ke buffer yang berisi teks pesan. Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

[in] buflen

Menentukan nilai yang berisi panjang, dalam byte, dari teks pesan yang ditujukkan oleh parameter buf .

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_PARAMETER
Parameter salah.
ERROR_NOT_SUPPORTED
Permintaan ini tidak didukung. Kesalahan ini dikembalikan pada Windows Vista dan yang lebih baru.
NERR_NameNotFound
Nama pengguna tidak dapat ditemukan.
NERR_NetworkError
Kegagalan umum terjadi pada perangkat keras jaringan.

Keterangan

Jika Anda memanggil fungsi ini pada pengendali domain yang menjalankan Direktori Aktif, akses diizinkan atau ditolak berdasarkan daftar kontrol akses (ACL) untuk objek yang dapat diamankan. ACL default hanya mengizinkan Admin Domain dan Operator Akun untuk memanggil fungsi ini. Pada server anggota atau stasiun kerja, hanya Administrator dan Operator Server yang dapat memanggil fungsi ini. Untuk informasi selengkapnya, lihat Persyaratan Keamanan untuk Fungsi Manajemen Jaringan. Untuk informasi selengkapnya tentang ACL dan ACL, lihat Model Access Control.

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

Lihat juga

Fungsi Pesan

NetMessageNameAdd

NetMessageNameDel

NetMessageNameEnum

NetMessageNameGetInfo

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan