Fungsi NetServerTransportAddEx (lmserver.h)

Artikel
08/24/2023

Fungsi NetServerTransportAddEx mengikat server yang ditentukan ke protokol transportasi. Fungsi yang diperluas ini memungkinkan aplikasi panggilan untuk menentukan tingkat informasi SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2, atau SERVER_TRANSPORT_INFO_3 .

Sintaks

NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
  [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 nilai yang menunjukkan tingkat informasi data. Parameter ini bisa menjadi salah satu 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 .
1	Menentukan informasi tentang protokol transportasi, termasuk nama, alamat, lokasi jaringan, dan domain. Parameter bufptr menunjuk ke struktur SERVER_TRANSPORT_INFO_1 .
2	Menentukan informasi yang sama dengan tingkat 1, dengan penambahan anggota svti2_flags . Parameter bufptr menunjuk ke struktur SERVER_TRANSPORT_INFO_2 .
3	Menentukan informasi yang sama dengan tingkat 2, dengan penambahan informasi kredensial. Parameter bufptr menunjuk ke struktur SERVER_TRANSPORT_INFO_3 .

[in] bufptr

Penunjuk ke buffer yang berisi data. Format data ini tergantung pada nilai parameter tingkat .

Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat 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 nama transportasi atau anggota alamat transportasi dalam struktur SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2, atau SERVER_TRANSPORT_INFO_3 yang ditujukkan oleh parameter bufptr adalah NULL. Kesalahan ini juga dikembalikan jika anggota panjang alamat transportasi dalam struktur SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2, atau SERVER_TRANSPORT_INFO_3 yang ditujukkan oleh parameter bufptr adalah nol atau lebih besar dari MAX_PATH (didefinisikan dalam file header Windef.h ). Kesalahan ini juga dikembalikan jika anggota bendera SERVER_TRANSPORT_INFO_2, atau struktur SERVER_TRANSPORT_INFO_3 yang ditujukkan oleh parameter bufptr berisi nilai ilegal. 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 NetServerTransportAddEx .

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

Fungsi NetServerComputerNameAdd adalah fungsi utilitas. Ini menggabungkan fitur fungsi NetServerTransportEnum dan fungsi NetServerTransportAddEx , memungkinkan Anda menentukan nama server yang ditiru.

Pada Windows Server 2008 dan Windows Vista dengan Paket Layanan 1 (SP1), setiap nama yang terdaftar di server file jarak jauh (SRV) Windows ditetapkan sebagai nama terlingkup atau nama yang tidak terlingkup. Setiap berbagi yang ditambahkan ke sistem kemudian akan dilampirkan ke semua nama yang tidak terlingkup, atau ke satu nama cakupan. Aplikasi yang ingin menggunakan fitur cakupan bertanggung jawab untuk mendaftarkan nama baru sebagai titik akhir tercakup dan kemudian membuat berbagi dengan cakupan yang sesuai. Dengan cara ini, penggunaan warisan dari fungsi Manajemen Jaringan dan Manajemen Berbagi Jaringan tidak terpengaruh dengan cara apa pun karena mereka terus mendaftarkan berbagi dan nama sebagai nama yang tidak terlingkup.

Titik akhir tercakup dibuat dengan memanggil fungsi NetServerTransportAddEx dengan parameter tingkat yang diatur ke 2 dan parameter bufptr menunjuk ke struktur SERVER_TRANSPORT_INFO_2 dengan nilai bit SVTI2_SCOPED_NAME diatur dalam anggota svti2_flags . Titik akhir tercakup juga dibuat dengan memanggil fungsi NetServerTransportAddEx dengan parameter tingkat diatur ke 3 dan parameter bufptr menunjuk ke struktur SERVER_TRANSPORT_INFO_3 dengan nilai bit SVTI2_SCOPED_NAME diatur dalam anggota svti3_flags .

Ketika nilai bit SVTI2_SCOPED_NAME diatur untuk transportasi, maka berbagi dapat ditambahkan dengan nama server yang sesuai (anggota shi503_servername struktur SHARE_INFO_503 ) dalam mode tercakup menggunakan fungsi NetShareAdd . Jika tidak ada transportasi yang terdaftar dengan nilai bit SVTI2_SCOPED_NAME dan nama yang disediakan dalam anggota shi503_servername , maka berbagi menambahkan dalam mode terlingkup tidak akan berhasil.

Fungsi NetShareAdd digunakan untuk menambahkan berbagi tercakup pada server jarak jauh yang ditentukan dalam parameter nama server . Server jarak jauh yang ditentukan dalam anggota shi503_servernameSHARE_INFO_503 yang diteruskan dalam parameter bufptr harus terikat ke protokol transportasi menggunakan fungsi NetServerTransportAddEx sebagai titik akhir tercakup. Bendera SVTI2_SCOPED_NAME harus ditentukan dalam anggota shi503_servername struktur SERVER_TRANSPORT_INFO_2 atau SERVER_TRANSPORT_INFO_3 untuk protokol transportasi. Fungsi NetShareDelEx digunakan untuk menghapus berbagi terlingkup. Fungsi NetShareGetInfo dan NetShareSetInfo digunakan untuk mendapatkan dan mengatur informasi tentang berbagi terlingkup.

Titik akhir terlingkup umumnya digunakan oleh namespace kluster.

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