Função NetServerTransportDel (lmserver.h)

A função NetServerTransportDel desvincula (ou desconecta) o protocolo de transporte do servidor. Efetivamente, o servidor não pode mais se comunicar com clientes usando o protocolo de transporte especificado (como TCP ou XNS).

Sintaxe

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

Parâmetros

[in] servername

Ponteiro para uma cadeia de caracteres que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

[in] level

Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
0
Especifica informações sobre o protocolo de transporte, incluindo nome, endereço e local na rede. O parâmetro bufptr aponta para uma estrutura de SERVER_TRANSPORT_INFO_0 .
1
Especifica informações sobre o protocolo de transporte, incluindo nome, endereço, local de rede e domínio. O parâmetro bufptr aponta para uma estrutura de SERVER_TRANSPORT_INFO_1 .

[in] bufptr

Ponteiro para o buffer que especifica os dados. O formato desses dados depende do valor do parâmetro de nível . Para obter mais informações, consulte Buffers de função de gerenciamento de rede.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_ACCESS_DENIED
O usuário não tem acesso às informações solicitadas.
ERROR_INVALID_LEVEL
O valor especificado para o parâmetro de nível é inválido.
ERROR_INVALID_PARAMETER
O parâmetro especificado é inválido.
ERROR_NOT_ENOUGH_MEMORY
Memória insuficiente disponível.
NERR_NetNameNotFound
O nome do compartilhamento não existe.

Comentários

Somente membros do grupo local Administradores ou Operadores de Servidor podem executar com êxito a função NetServerTransportDel .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho lmserver.h (inclua Lm.h)
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

NetServerTransportAdd

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

Funções de transporte de servidor e estação de trabalho