estructura SERVER_TRANSPORT_INFO_2 (lmserver.h)
La estructura SERVER_TRANSPORT_INFO_2 contiene información sobre el protocolo de transporte especificado, incluido el nombre y la dirección de transporte. Este nivel de información solo es válido para la función NetServerTransportAddEx .
Sintaxis
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
Número de clientes conectados al servidor que usan el protocolo de transporte especificado por el miembro svti2_transportname .
svti2_transportname
Tipo: LMSTR
Puntero a una cadena de caracteres terminada en NULL que contiene el nombre de un dispositivo de transporte; por ejemplo,
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .
svti2_transportaddress
Tipo: LPBYTE
Puntero a una variable que contiene la dirección que usa el servidor en el dispositivo de transporte especificado por el miembro svti2_transportname .
Este miembro suele ser el nombre netBIOS que usa el servidor. En estos casos, el nombre debe tener 16 caracteres y el último carácter debe ser un carácter en blanco (0x20).
svti2_transportaddresslength
Tipo: DWORD
Longitud, en bytes, del miembro svti2_transportaddress . Para los nombres NetBIOS, el valor de este miembro es 16 (decimal).
svti2_networkaddress
Tipo: LMSTR
Puntero a una cadena de caracteres terminada en NULL que contiene la dirección que usa el adaptador de red. La cadena es específica del transporte.
Este valor solo se puede recuperar con una llamada a la función NetServerTransportEnum . No se puede establecer este valor con una llamada a la función NetServerTransportAdd o a la función NetServerTransportAddEx ).
Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .
svti2_domain
Tipo: LMSTR
Puntero a una cadena de caracteres terminada en NULL que contiene el nombre del dominio al que el servidor debe anunciar su presencia. (Cuando se llama a NetServerTransportEnum, este miembro es el nombre del dominio al que el servidor anuncia su presencia).
Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .
svti2_flags
Tipo: ULONG
Este miembro puede ser una combinación de los siguientes valores de bits definidos en el archivo de encabezado Lmserver.h .
Comentarios
La estructura SERVER_TRANSPORT_INFO_2 la usa la función NetServerTransportAddEx para enlazar el servidor especificado al protocolo de transporte.
A continuación se muestra un ejemplo del uso del valor de SVTI2_REMAP_PIPE_NAMES. Llame a la función NetServerTransportAddEx para agregar un transporte al servidor, especificando la dirección "MyServer" en el miembro svti2_transportaddress y SVTI2_REMAP_PIPE_NAMES en el miembro svti2_flags . Cuando un cliente intenta abrir "Pipe" en "\MyServer", el cliente realmente abrirá $$MyServer\Pipe en su lugar.
En Windows Server 2008 y Windows Vista con SP1, todos los nombres registrados con el servidor de archivos remotos de Windows (SRV) se designan como un nombre con ámbito o un nombre no con ámbito. Cada recurso compartido que se agrega al sistema se asociará a todos los nombres no con ámbito o a un nombre de ámbito único. Las aplicaciones que desean usar las características de ámbito son responsables de registrar el nuevo nombre como punto de conexión con ámbito y, a continuación, crear los recursos compartidos con un ámbito adecuado. De este modo, los usos heredados de las funciones administración de redes y administración de recursos compartidos de red no se ven afectados de ninguna manera, ya que siguen registrando recursos compartidos y nombres como nombres no con ámbito.
Se crea un punto de conexión con ámbito llamando a la función NetServerTransportAddExcon el parámetro level establecido en 2 y el parámetro bufptr apunta a una estructura de SERVER_TRANSPORT_INFO_2 con el valor de bits de SVTI2_SCOPED_NAME establecido en svti2_flags miembro. También se crea un punto de conexión con ámbito llamando a la función NetServerTransportAddExcon el parámetro level establecido en 3 y el parámetro bufptr apunta a una estructura de SERVER_TRANSPORT_INFO_3 con el valor de bits de SVTI2_SCOPED_NAME establecido en svti3_flags miembro.
Cuando se establece el valor de bit de SVTI2_SCOPED_NAME para un transporte, los recursos compartidos se pueden agregar con un nombre de servidor correspondiente (el miembro shi503_servername de la estructura SHARE_INFO_503 ) de forma con ámbito mediante la función NetShareAdd . Si no hay ningún transporte registrado con el valor de bit de SVTI2_SCOPED_NAME y el nombre proporcionado en shi503_servername miembro, el complemento compartido no se realizará correctamente.
La función NetShareAdd se usa para agregar un recurso compartido con ámbito en un servidor remoto especificado en el parámetro servername . El servidor remoto especificado en el miembro shi503_servername del SHARE_INFO_503 pasado en el parámetro bufptr debe haberse enlazado a un protocolo de transporte mediante la función NetServerTransportAddEx como punto de conexión con ámbito. La marca SVTI2_SCOPED_NAME debe haberse especificado en el miembro shi503_servername de la estructura SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 para el protocolo de transporte. La función NetShareDelEx se usa para eliminar un recurso compartido con ámbito. Las funciones NetShareGetInfo y NetShareSetInfo se usan para obtener y establecer información en un recurso compartido con ámbito.
Los puntos de conexión con ámbito suelen usarse en el espacio de nombres del clúster.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | lmserver.h (include Lm.h) |
Consulte también
Introducción a la administración de redes