Función NetServerTransportAddEx (lmserver.h)

Artículo
08/24/2023

La función NetServerTransportAddEx enlaza el servidor especificado al protocolo de transporte. Esta función extendida permite a la aplicación que llama especificar los niveles de información de SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 .

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Parámetros

[in] servername

Puntero a una cadena que especifica el nombre del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

[in] level

Especifica un valor que indica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
0	Especifica información sobre el protocolo de transporte, incluido el nombre, la dirección y la ubicación de la red. El parámetro bufptr apunta a una estructura SERVER_TRANSPORT_INFO_0 .
1	Especifica información sobre el protocolo de transporte, incluido el nombre, la dirección, la ubicación de red y el dominio. El parámetro bufptr apunta a una estructura de SERVER_TRANSPORT_INFO_1 .
2	Especifica la misma información que el nivel 1, con la adición de un miembro de svti2_flags . El parámetro bufptr apunta a una estructura SERVER_TRANSPORT_INFO_2 .
3	Especifica la misma información que el nivel 2, con la adición de información de credenciales. El parámetro bufptr apunta a una estructura SERVER_TRANSPORT_INFO_3 .

[in] bufptr

Puntero al búfer que contiene los datos. El formato de estos datos depende del valor del parámetro level .

Para obtener más información, consulte Búferes de funciones de administración de redes.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El usuario no tiene acceso a la información pedida.
ERROR_DUP_NAME	Existe un nombre duplicado en la red.
ERROR_INVALID_DOMAINNAME	No se encontró el nombre de dominio en la red.
ERROR_INVALID_LEVEL	El valor especificado para el parámetro level no es válido.
ERROR_INVALID_PARAMETER	Si se devuelve este valor, significará que el parámetro en cuestión no es válido. Este error se devuelve si el nombre de transporte o el miembro de dirección de transporte del SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 estructura a la que apunta el parámetro bufptr es NULL. Este error también se devuelve si el miembro de longitud de dirección de transporte del SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o estructura de SERVER_TRANSPORT_INFO_3 apuntado por el parámetro bufptr es cero o mayor que MAX_PATH (definido en el archivo de encabezado Windef.h ). Este error también se devuelve si el miembro flags del SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 estructura a la que apunta el parámetro bufptr contiene un valor no válido. Este error también se devuelve para otros parámetros no válidos.
ERROR_NOT_ENOUGH_MEMORY	Memoria insuficiente disponible.

Comentarios

Solo los miembros del grupo local Administradores o Operadores de servidor pueden ejecutar correctamente la función NetServerTransportAddEx .

Si agrega un protocolo de transporte a un servidor mediante una llamada a la función NetServerTransportAddEx , la conexión no permanecerá después de que el servidor se reinicie o reinicie.

La función NetServerComputerNameAdd es una función de utilidad. Combina las características de la función NetServerTransportEnum y la función NetServerTransportAddEx , lo que le permite especificar un nombre de servidor emulado.

En Windows Server 2008 y Windows Vista con Service Pack 1 (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 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]
Plataforma de destino	Windows
Encabezado	lmserver.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll