Share via

Função NetWkstaTransportAdd (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 Conexões de Rede e Discagem .]

Sem suporte.

A função NetWkstaTransportAdd associa (ou conecta) o redirecionador ao transporte. O redirecionador é o software no computador cliente que gera solicitações de arquivo para o computador servidor.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

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] level

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

Valor Significado
0
 Especifica informações de protocolo de transporte de estação de trabalho. O parâmetro buf aponta para uma estrutura de WKSTA_TRANSPORT_INFO_0 .

[in] buf

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.

[out] parm_err

Ponteiro para um valor que recebe o índice do primeiro parâmetro que causa o erro ERROR_INVALID_PARAMETER. Se esse parâmetro for NULL, o índice não será retornado por erro.

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 parâmetro level, que indica qual nível de informações de estrutura de dados está disponível, é inválido.
ERROR_INVALID_PARAMETER
 Um dos parâmetros de função é inválido.

Comentários

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

Se a função NetWkstaTransportAdd retornar ERROR_INVALID_PARAMETER, você poderá usar o parâmetro parm_err para indicar o membro da estrutura WKSTA_TRANSPORT_INFO_0 inválida. A tabela a seguir lista os valores que podem ser retornados no parâmetro parm_err e no membro de estrutura correspondente que está em erro.

Valor Membro
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

Requisitos

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