Share via

Função NetWkstaTransportDel (lmwksta.h)

  • Artigo

[Essa função está obsoleta. Para alterar manualmente as configurações padrão dos protocolos de transporte, use a caixa de diálogo Propriedades de Conexão de Área Local na pasta Connections Rede e Discagem.]

Não há suporte.

A função NetWkstaTransportDel desassocia o protocolo de transporte do redirecionador. (O redirecionador é o software no computador cliente que gera solicitações de arquivo para o computador servidor.)

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

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.

Essa cadeia de caracteres deve começar com \.

[in] transportname

Ponteiro para uma cadeia de caracteres que especifica o nome do protocolo de transporte a ser desconectado do redirecionador.

[in] ucond

Especifica o nível de força a ser usado ao desconectar o protocolo de transporte do redirecionador. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
USE_NOFORCE
 Falha na desconexão se houver arquivos abertos na conexão.
USE_FORCE
 Falha na desconexão se houver arquivos abertos na conexão.
USE_LOTS_OF_FORCE
 Feche todos os arquivos abertos e exclua a conexão.

Retornar valor

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 códigos de erro a seguir.

Código de retorno Descrição
ERROR_ACCESS_DENIED
 O usuário não tem acesso às informações solicitadas.
ERROR_INVALID_PARAMETER
 Um dos parâmetros de função é inválido.
NERR_UseNotFound
 A conexão de rede não existe.

Comentários

Somente os membros do grupo local Administradores podem executar com êxito a função NetWkstaTransportDel .

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho lmwksta.h (inclua Lm.h, Lmwksta.h)
Biblioteca Netapi32.lib
DLL Netapi32.dll