struktur SERVER_TRANSPORT_INFO_2 (lmserver.h)

Artikel
03/14/2023

Struktur SERVER_TRANSPORT_INFO_2 berisi informasi tentang protokol transportasi yang ditentukan, termasuk nama dan alamat transportasi. Tingkat informasi ini hanya valid untuk fungsi NetServerTransportAddEx .

Sintaks

typedef struct _SERVER_TRANSPORT_INFO_2 {
  DWORD  svti2_numberofvcs;
  LMSTR  svti2_transportname;
  LPBYTE svti2_transportaddress;
  DWORD  svti2_transportaddresslength;
  LMSTR  svti2_networkaddress;
  LMSTR  svti2_domain;
  ULONG  svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;

Anggota

svti2_numberofvcs

Jenis: DWORD

Jumlah klien yang tersambung ke server yang menggunakan protokol transportasi yang ditentukan oleh anggota svti2_transportname .

svti2_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.

svti2_transportaddress

Jenis: LPBYTE

Penunjuk ke variabel yang berisi alamat yang digunakan server pada perangkat transportasi yang ditentukan oleh anggota svti2_transportname .

Anggota ini biasanya adalah nama NetBIOS yang digunakan server. Dalam kasus ini, nama harus terdiri dari 16 karakter, dan karakter terakhir harus berupa karakter kosong (0x20).

svti2_transportaddresslength

Jenis: DWORD

Panjang, dalam byte, dari anggota svti2_transportaddress . Untuk nama NetBIOS, nilai anggota ini adalah 16 (desimal).

svti2_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.

svti2_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.

svti2_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 terlingkup 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 terlingkup yang sama.

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

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

Keterangan

Struktur SERVER_TRANSPORT_INFO_2 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 svti2_transportaddress , dan SVTI2_REMAP_PIPE_NAMES di anggota svti2_flags . Ketika klien mencoba membuka "Pipe" pada "\MyServer" klien akan benar-benar membuka $$MyServer\Pipe sebagai gantinya.

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 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]
Header	lmserver.h (termasuk Lm.h)