Función NetServerTransportAdd (lmserver.h)

Artículo
08/24/2023

La función NetServerTransportAdd enlaza el servidor al protocolo de transporte.

La función extendida NetServerTransportAddEx permite a la aplicación que llama especificar los niveles de información de SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 y SERVER_TRANSPORT_INFO_3 .

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [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 el nivel de información de los datos. Este parámetro puede ser el siguiente valor.

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 .

[in] bufptr

Puntero al búfer que contiene los datos.

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 miembro svti0_transportname o svti0_transportaddress de la estructura SERVER_TRANSPORT_INFO_0 a la que apunta el parámetro bufptr es NULL. Este error también se devuelve si el miembro svti0_transportaddresslength de la estructura SERVER_TRANSPORT_INFO_0 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 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 NetServerTransportAdd .

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

Requisitos

Requisito	Value
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