Fungsi NetServerTransportAdd (lmserver.h)

Artikel
03/14/2023

Fungsi NetServerTransportAdd mengikat server ke protokol transportasi.

Fungsi yang diperluas NetServerTransportAddEx memungkinkan aplikasi panggilan untuk menentukan tingkat informasi SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2, dan SERVER_TRANSPORT_INFO_3 .

Sintaks

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Parameter

[in] servername

Penunjuk ke string yang menentukan nama server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] level

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

Nilai	Makna
0	Menentukan informasi tentang protokol transportasi, termasuk nama, alamat, dan lokasi pada jaringan. Parameter bufptr menunjuk ke struktur SERVER_TRANSPORT_INFO_0 .

[in] bufptr

Penunjuk ke buffer yang berisi data.

Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

Mengembalikan 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	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_DUP_NAME	Nama duplikat ada di jaringan.
ERROR_INVALID_DOMAINNAME	Nama domain tidak dapat ditemukan pada jaringan.
ERROR_INVALID_LEVEL	Nilai yang ditentukan untuk parameter tingkat tidak valid.
ERROR_INVALID_PARAMETER	Parameter tidak valid. Kesalahan ini dikembalikan jika anggota svti0_transportname atau svti0_transportaddress dalam struktur SERVER_TRANSPORT_INFO_0 yang diacu oleh parameter bufptr adalah NULL. Kesalahan ini juga dikembalikan jika anggota svti0_transportaddresslength dalam struktur SERVER_TRANSPORT_INFO_0 yang ditunjukkan oleh parameter bufptr adalah nol atau lebih besar dari MAX_PATH (didefinisikan dalam file header Windef.h). Kesalahan ini juga dikembalikan untuk parameter lain yang tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia.

Keterangan

Hanya anggota grup lokal Administrator atau Operator Server yang berhasil menjalankan fungsi NetServerTransportAdd .

Jika Anda menambahkan protokol transportasi ke server menggunakan panggilan ke fungsi NetServerTransportAdd , koneksi tidak akan tetap ada setelah server memulai ulang atau memulai ulang.

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