struttura SERVER_TRANSPORT_INFO_2 (lmserver.h)
La struttura SERVER_TRANSPORT_INFO_2 contiene informazioni sul protocollo di trasporto specificato, inclusi il nome e l'indirizzo del trasporto. Questo livello di informazioni è valido solo per la funzione NetServerTransportAddEx .
Sintassi
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;
Members
svti2_numberofvcs
Tipo: DWORD
Numero di client connessi al server che utilizzano il protocollo di trasporto specificato dal membro svti2_transportname .
svti2_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 .
svti2_transportaddress
Tipo: LPBYTE
Puntatore a una variabile che contiene l'indirizzo utilizzato dal server nel dispositivo di trasporto specificato dal membro svti2_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).
svti2_transportaddresslength
Tipo: DWORD
Lunghezza, in byte, del membro svti2_transportaddress . Per i nomi NetBIOS, il valore di questo membro è 16 (decimale).
svti2_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 .
svti2_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 .
svti2_flags
Tipo: ULONG
Questo membro può essere una combinazione dei valori di bit seguenti definiti nel file di intestazione Lmserver.h .
Commenti
La struttura SERVER_TRANSPORT_INFO_2 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 svti2_transportaddress e SVTI2_REMAP_PIPE_NAMES nel membro svti2_flags . Quando un client tenta di aprire "Pipe" in "\MyServer", il client aprirà invece $$MyServer\Pipe.
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) |