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 |
---|---|
|
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 . |
|
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 |
---|---|
|
O usuário não tem acesso às informações solicitadas. |
|
O valor especificado para o parâmetro de nível é inválido. |
|
O parâmetro especificado é inválido. |
|
Memória insuficiente disponível. |
|
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
Funções de gerenciamento de rede