struttura SERVER_TRANSPORT_INFO_3 (lmserver.h)

Articolo
03/14/2023

La struttura SERVER_TRANSPORT_INFO_3 contiene informazioni sul protocollo di trasporto specificato, inclusi nome, indirizzo e password (credenziali). Questo livello di informazioni è valido solo per la funzione NetServerTransportAddEx .

Sintassi

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;

Members

svti3_numberofvcs

Tipo: DWORD

Numero di client connessi al server che utilizzano il protocollo di trasporto specificato dal membro svti3_transportname .

svti3_transportname

Tipo: LMSTR

Puntatore a una stringa di caratteri con terminazione NULL contenente il nome di un dispositivo di trasporto; Per esempio

\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

svti3_transportaddress

Tipo: LPBYTE

Puntatore a una variabile che contiene l'indirizzo utilizzato dal server nel dispositivo di trasporto specificato dal membro svti3_transportname .

Questo membro è in genere il nome NetBIOS usato dal server. In questi casi, il nome deve avere una lunghezza di 16 caratteri e l'ultimo carattere deve essere un carattere vuoto (0x20).

svti3_transportaddresslength

Tipo: DWORD

Lunghezza, in byte, del membro svti3_transportaddress . Per i nomi NetBIOS, il valore di questo membro è 16 (decimale).

svti3_networkaddress

Tipo: LMSTR

Puntatore a una stringa di caratteri con terminazione NULL che contiene l'indirizzo utilizzato dalla scheda di rete. La stringa è specifica del trasporto.

È possibile recuperare questo valore solo con una chiamata alla funzione NetServerTransportEnum . Non è possibile impostare questo valore con una chiamata alla funzione NetServerTransportAdd o alla funzione NetServerTransportAddEx .

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

svti3_domain

Tipo: LMSTR

Puntatore a una stringa di caratteri con terminazione NULL contenente il nome del dominio a cui il server deve annunciarne la presenza. Quando si chiama NetServerTransportEnum, questo membro è il nome del dominio a cui il server annuncia la sua presenza.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

svti3_flags

Tipo: ULONG

Questo membro può essere una combinazione dei valori di bit seguenti definiti nel file di intestazione Lmserver.h .

Valore	Significato
SVTI2_REMAP_PIPE_NAMES	Se questo valore è impostato per un endpoint, le richieste client in arrivo sul trasporto per aprire una named pipe vengono reindirizzate (mappate) al nome della pipe locale seguente: $$\NomeServer\PipeName Per altre informazioni sull'uso di questo valore, vedere la sezione Osservazioni.
SVTI2_SCOPED_NAME	Se questo valore è impostato per un endpoint e si tenta di creare un secondo trasporto con lo stesso indirizzo di rete, ma un nome di trasporto diverso e impostazioni in conflitto per il flag SCOPED, la creazione del trasporto avrà esito negativo. Pertanto, ogni trasporto registrato per un determinato indirizzo di rete deve avere la stessa impostazione con ambito. Per altre informazioni sull'uso di questo valore, vedere la sezione Osservazioni. Questo valore è definito in Windows Server 2008 e Windows Vista con SP1.

Valore

Significato

SVTI2_REMAP_PIPE_NAMES

Se questo valore è impostato per un endpoint, le richieste client in arrivo sul trasporto per aprire una named pipe vengono reindirizzate (mappate) al nome della pipe locale seguente:

$$\NomeServer\PipeName

Per altre informazioni sull'uso di questo valore, vedere la sezione Osservazioni.

SVTI2_SCOPED_NAME

Se questo valore è impostato per un endpoint e si tenta di creare un secondo trasporto con lo stesso indirizzo di rete, ma un nome di trasporto diverso e impostazioni in conflitto per il flag SCOPED, la creazione del trasporto avrà esito negativo. Pertanto, ogni trasporto registrato per un determinato indirizzo di rete deve avere la stessa impostazione con ambito.

Per altre informazioni sull'uso di questo valore, vedere la sezione Osservazioni.

Questo valore è definito in Windows Server 2008 e Windows Vista con SP1.

svti3_passwordlength

Tipo: DWORD

Numero di byte validi nel membro svti3_password .

svti3_password[256]

Tipo: BYTE[256]

Credenziali da utilizzare per il nuovo indirizzo di trasporto. Se il membro svti3_passwordlength è zero, vengono usate le credenziali per il server.

Commenti

La struttura SERVER_TRANSPORT_INFO_3 viene utilizzata dalla funzione NetServerTransportAddEx per associare il server specificato al protocollo di trasporto.

Di seguito è riportato un esempio dell'uso del valore SVTI2_REMAP_PIPE_NAMES. Chiamare la funzione NetServerTransportAddEx per aggiungere un trasporto al server, specificando l'indirizzo di "MyServer" nel membro svti3_transportaddress e SVTI2_REMAP_PIPE_NAMES nel membro svti3_flags . Quando un client tenta di aprire "Pipe" in "\MyServer", il client aprirà invece $$MyServer\Pipe.

I membri svti3_passwordlength e svti3_password sono necessari per eseguire l'autenticazione reciproca da parte di un client e di un server.

In Windows Server 2008 e Windows Vista con SP1, ogni nome registrato con il file server remoto windows (SRV) viene designato come nome con ambito o nome non con ambito. Ogni condivisione aggiunta al sistema verrà quindi collegata a tutti i nomi non con ambito o a un singolo nome con ambito. Le applicazioni che desiderano usare le funzionalità di ambito sono responsabili della registrazione del nuovo nome come endpoint con ambito e quindi della creazione delle condivisioni con un ambito appropriato. In questo modo, gli usi legacy delle funzioni Gestione rete e Gestione condivisione di rete non sono interessati in alcun modo perché continuano a registrare condivisioni e nomi come nomi non con ambito.

Un endpoint con ambito viene creato chiamando la funzione NetServerTransportAddEx con il parametro level impostato su 2 e il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_2 con il valore di bit SVTI2_SCOPED_NAME impostato in svti2_flags membro. Viene creato anche un endpoint con ambito chiamando la funzione NetServerTransportAddEx con il parametro level impostato su 3 e il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_3 con il valore di bit SVTI2_SCOPED_NAME impostato nel membro svti3_flags .

Quando il valore di bit SVTI2_SCOPED_NAME è impostato per un trasporto, le condivisioni possono essere aggiunte con un nome del server corrispondente (il membro shi503_servername della struttura SHARE_INFO_503 ) in modo con ambito tramite la funzione NetShareAdd . Se non è presente alcun trasporto registrato con il valore di bit SVTI2_SCOPED_NAME e il nome specificato nel membro shi503_servername , l'aggiunta di condivisione in modo con ambito non avrà esito positivo.

La funzione NetShareAdd viene usata per aggiungere una condivisione con ambito in un server remoto specificato nel parametro servername . Il server remoto specificato nel membro shi503_servername del SHARE_INFO_503 passato nel parametro bufptr deve essere stato associato a un protocollo di trasporto usando la funzione NetServerTransportAddEx come endpoint con ambito. Il flag SVTI2_SCOPED_NAME deve essere stato specificato nel membro shi503_servername della struttura SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 per il protocollo di trasporto. La funzione NetShareDelEx viene usata per eliminare una condivisione con ambito. Le funzioni NetShareGetInfo e NetShareSetInfo consentono di ottenere e impostare informazioni su una condivisione con ambito.

Gli endpoint con ambito vengono in genere usati dallo spazio dei nomi del cluster.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	lmserver.h (include Lm.h)