estructura SERVER_TRANSPORT_INFO_3 (lmserver.h)

Artículo
03/14/2023

La estructura SERVER_TRANSPORT_INFO_3 contiene información sobre el protocolo de transporte especificado, incluidos el nombre, la dirección y la contraseña (credenciales). Este nivel de información solo es válido para la función NetServerTransportAddEx .

Sintaxis

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

Número de clientes conectados al servidor que usan el protocolo de transporte especificado por el miembro svti3_transportname .

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

svti3_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 svti3_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).

svti3_transportaddresslength

Tipo: DWORD

Longitud, en bytes, del miembro svti3_transportaddress . Para los nombres NetBIOS, el valor de este miembro es 16 (decimal).

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

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

svti3_flags

Tipo: ULONG

Este miembro puede ser una combinación de los siguientes valores de bits definidos en el archivo de encabezado Lmserver.h .

Valor	Significado
SVTI2_REMAP_PIPE_NAMES	Si este valor se establece para un punto de conexión, las solicitudes de cliente que llegan al transporte para abrir una canalización con nombre se enrutan (reasignan) al siguiente nombre de canalización local: $$\ServerName\PipeName Para obtener más información sobre el uso de este valor, vea la sección Comentarios.
SVTI2_SCOPED_NAME	Si este valor se establece para un punto de conexión y hay un intento de crear un segundo transporte con la misma dirección de red, pero un nombre de transporte diferente y una configuración en conflicto para la marca SCOPED, se producirá un error en esta creación de transporte. Por lo tanto, cada transporte registrado para una dirección de red determinada debe tener la misma configuración de ámbito. Para obtener más información sobre el uso de este valor, vea la sección Comentarios. Este valor se define en Windows Server 2008 y Windows Vista con SP1.

Valor

Significado

SVTI2_REMAP_PIPE_NAMES

Si este valor se establece para un punto de conexión, las solicitudes de cliente que llegan al transporte para abrir una canalización con nombre se enrutan (reasignan) al siguiente nombre de canalización local:

$$\ServerName\PipeName

Para obtener más información sobre el uso de este valor, vea la sección Comentarios.

SVTI2_SCOPED_NAME

Si este valor se establece para un punto de conexión y hay un intento de crear un segundo transporte con la misma dirección de red, pero un nombre de transporte diferente y una configuración en conflicto para la marca SCOPED, se producirá un error en esta creación de transporte. Por lo tanto, cada transporte registrado para una dirección de red determinada debe tener la misma configuración de ámbito.

Para obtener más información sobre el uso de este valor, vea la sección Comentarios.

Este valor se define en Windows Server 2008 y Windows Vista con SP1.

svti3_passwordlength

Tipo: DWORD

Número de bytes válidos en el miembro svti3_password .

svti3_password[256]

Tipo: BYTE[256]

Credenciales que se van a usar para la nueva dirección de transporte. Si el miembro svti3_passwordlength es cero, se usan las credenciales del servidor.

Comentarios

La función NetServerTransportAddEx usa la estructura SERVER_TRANSPORT_INFO_3 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 de "MyServer" en el miembro svti3_transportaddress y SVTI2_REMAP_PIPE_NAMES en el miembro svti3_flags . Cuando un cliente intenta abrir "Pipe" en "\MyServer", el cliente realmente abrirá $$MyServer\Pipe en su lugar.

Los miembros svti3_passwordlength y svti3_password son necesarios para que un cliente y un servidor realicen la autenticación mutua.

En Windows Server 2008 y Windows Vista con SP1, cada nombre registrado con el servidor de archivos remoto de Windows (SRV) se designa 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 esta manera, 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.

Un punto de conexión con ámbito se crea mediante una llamada a la función NetServerTransportAddEx con 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 mediante una llamada a la función NetServerTransportAddEx con el parámetro level establecido en 3 y el parámetro bufptr apunta a una estructura 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 de forma con ámbito 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)