struktur SERVER_TRANSPORT_INFO_3 (lmserver.h)
Struktur SERVER_TRANSPORT_INFO_3 berisi informasi tentang protokol transportasi yang ditentukan, termasuk nama, alamat, dan kata sandi (kredensial). Tingkat informasi ini hanya valid untuk fungsi NetServerTransportAddEx .
Sintaks
typedef struct _SERVER_TRANSPORT_INFO_3 {
DWORD svti3_numberofvcs;
LMSTR svti3_transportname;
LPBYTE svti3_transportaddress;
DWORD svti3_transportaddresslength;
LMSTR svti3_networkaddress;
LMSTR svti3_domain;
ULONG svti3_flags;
DWORD svti3_passwordlength;
BYTE svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;
Anggota
svti3_numberofvcs
Jenis: DWORD
Jumlah klien yang tersambung ke server yang menggunakan protokol transportasi yang ditentukan oleh anggota svti3_transportname .
svti3_transportname
Jenis: LMSTR
Penunjuk ke string karakter yang dihentikan NULL yang berisi nama perangkat transportasi; misalnya,
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.
svti3_transportaddress
Jenis: LPBYTE
Penunjuk ke variabel yang berisi alamat yang digunakan server pada perangkat transportasi yang ditentukan oleh anggota svti3_transportname .
Anggota ini biasanya adalah nama NetBIOS yang digunakan server. Dalam kasus ini, panjang nama harus 16 karakter, dan karakter terakhir harus berupa karakter kosong (0x20).
svti3_transportaddresslength
Jenis: DWORD
Panjangnya, dalam byte, dari anggota svti3_transportaddress . Untuk nama NetBIOS, nilai anggota ini adalah 16 (desimal).
svti3_networkaddress
Jenis: LMSTR
Penunjuk ke string karakter yang dihentikan NULL yang berisi alamat yang digunakan adaptor jaringan. String ini khusus untuk transportasi.
Anda hanya dapat mengambil nilai ini dengan panggilan ke fungsi NetServerTransportEnum . Anda tidak dapat mengatur nilai ini dengan panggilan ke fungsi NetServerTransportAdd atau fungsi NetServerTransportAddEx .)
String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.
svti3_domain
Jenis: LMSTR
Penunjuk ke string karakter yang dihentikan NULL yang berisi nama domain tempat server harus mengumumkan kehadirannya. (Ketika Anda memanggil NetServerTransportEnum, anggota ini adalah nama domain tempat server mengumumkan kehadirannya.)
String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.
svti3_flags
Jenis: ULONG
Anggota ini bisa menjadi kombinasi dari nilai bit berikut yang ditentukan dalam file header Lmserver.h .
svti3_passwordlength
Jenis: DWORD
Jumlah byte yang valid dalam anggota svti3_password .
svti3_password[256]
Jenis: BYTE[256]
Kredensial yang digunakan untuk alamat transportasi baru. Jika anggota svti3_passwordlength adalah nol, kredensial untuk server akan digunakan.
Keterangan
Struktur SERVER_TRANSPORT_INFO_3 digunakan oleh fungsi NetServerTransportAddEx untuk mengikat server yang ditentukan ke protokol transportasi.
Contoh penggunaan nilai SVTI2_REMAP_PIPE_NAMES berikut. Panggil fungsi NetServerTransportAddEx untuk menambahkan transportasi ke server, menentukan alamat "MyServer" di anggota svti3_transportaddress , dan SVTI2_REMAP_PIPE_NAMES di anggota svti3_flags . Ketika klien mencoba membuka "Pipe" pada "\MyServer" klien akan benar-benar membuka $$MyServer\Pipe sebagai gantinya.
Anggota svti3_passwordlength dan svti3_password diperlukan bagi klien dan server untuk melakukan autentikasi timbal balik.
Pada Windows Server 2008 dan Windows Vista dengan SP1, setiap nama yang terdaftar di server file jarak jauh (SRV) Windows ditetapkan sebagai nama cakupan 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 yang 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, berbagi dapat ditambahkan dengan nama server yang sesuai (anggota shi503_servername struktur SHARE_INFO_503 ) dengan cara 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 shi503_servername anggota SHARE_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] |
Header | lmserver.h (termasuk Lm.h) |