estructura SERVER_TRANSPORT_INFO_3 (lmserver.h)
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 .
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) |
Consulte también
Introducción a la administración de redes