Função NetWkstaTransportAdd (lmwksta.h)

[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.

[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.

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.

Requisitos