struktur SERVER_TRANSPORT_INFO_3 (lmserver.h)

Artikel
03/14/2023

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 .

Nilai	Makna
SVTI2_REMAP_PIPE_NAMES	Jika nilai ini diatur untuk titik akhir, permintaan klien yang tiba di atas transportasi untuk membuka pipa bernama dirutekan ulang (dipetakan ulang) ke nama pipa lokal berikut: $$\ServerName\PipeName Untuk informasi selengkapnya tentang penggunaan nilai ini, lihat bagian Keterangan.
SVTI2_SCOPED_NAME	Jika nilai ini diatur untuk titik akhir dan ada upaya untuk membuat transportasi kedua dengan alamat jaringan yang sama tetapi nama transportasi yang berbeda dan pengaturan yang bertentangan untuk bendera SCOPED, pembuatan transportasi ini akan gagal. Dengan demikian, setiap transportasi terdaftar untuk alamat jaringan tertentu harus memiliki pengaturan cakupan yang sama. Untuk informasi selengkapnya tentang penggunaan nilai ini, lihat bagian Keterangan. Nilai ini ditentukan pada Windows Server 2008 dan Windows Vista dengan SP1.

Nilai

Makna

SVTI2_REMAP_PIPE_NAMES

Jika nilai ini diatur untuk titik akhir, permintaan klien yang tiba di atas transportasi untuk membuka pipa bernama dirutekan ulang (dipetakan ulang) ke nama pipa lokal berikut:

$$\ServerName\PipeName

Untuk informasi selengkapnya tentang penggunaan nilai ini, lihat bagian Keterangan.

SVTI2_SCOPED_NAME

Jika nilai ini diatur untuk titik akhir dan ada upaya untuk membuat transportasi kedua dengan alamat jaringan yang sama tetapi nama transportasi yang berbeda dan pengaturan yang bertentangan untuk bendera SCOPED, pembuatan transportasi ini akan gagal. Dengan demikian, setiap transportasi terdaftar untuk alamat jaringan tertentu harus memiliki pengaturan cakupan yang sama.

Untuk informasi selengkapnya tentang penggunaan nilai ini, lihat bagian Keterangan.

Nilai ini ditentukan pada Windows Server 2008 dan Windows Vista dengan SP1.

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)