Función NetServerTransportDel (lmserver.h)

La función NetServerTransportDel desenlace (o desconecta) el protocolo de transporte del servidor. De hecho, el servidor ya no puede comunicarse con los clientes mediante el protocolo de transporte especificado (como TCP o XNS).

Sintaxis

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

Parámetros

[in] servername

Puntero a una cadena que especifica el nombre DNS o NetBIOS 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 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 .

[in] bufptr

Puntero al búfer que especifica 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_INVALID_LEVEL
El valor especificado para el parámetro level no es válido.
ERROR_INVALID_PARAMETER
El parámetro especificado no es válido.
ERROR_NOT_ENOUGH_MEMORY
Memoria insuficiente disponible.
NERR_NetNameNotFound
El nombre del recurso compartido no existe.

Comentarios

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

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

Consulte también

NetServerTransportAdd

Funciones de administración de red

Introducción a la administración de redes

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

Funciones de transporte de servidor y estación de trabajo