Condividi tramite


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 .

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.

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)

Vedi anche

NetServerComputerNameAggiungi

NetServerComputerNameDel

NetServerTransportAdd

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

NetShareAdd

NetShareDelEx

NetShareGetInfo

NetShareSetInfo

Panoramica della gestione della rete

Strutture di gestione di rete

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_3

SHARE_INFO_503

Funzioni di trasporto server e workstation