Compartilhar via

Função MprAdminInterfaceSetCredentials (mprapi.h)

  • Artigo

Use a função MprAdminInterfaceSetCredentials para definir o domínio, o nome de usuário e a senha que serão usados para discar na interface demand-dial especificada.

Sintaxe

DWORD MprAdminInterfaceSetCredentials(
  [in] LPWSTR lpwsServer,
  [in] LPWSTR lpwsInterfaceName,
  [in] LPWSTR lpwsUserName,
  [in] LPWSTR lpwsDomainName,
  [in] LPWSTR lpwsPassword
);

Parâmetros

[in] lpwsServer

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do roteador no qual executar essa chamada.

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a chamada será executada no computador local.

[in] lpwsInterfaceName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da interface demand-dial. Use MprAdminInterfaceGetInfo para obter o nome da interface.

[in] lpwsUserName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome de usuário.

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não alterará o nome de usuário associado a essa interface.

[in] lpwsDomainName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome de domínio.

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não alterará o nome de domínio associado a essa interface.

[in] lpwsPassword

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica a senha.

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não alterará a senha associada a essa interface.

Valor retornado

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

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

Valor Significado
ERROR_INVALID_PARAMETER
 Pelo menos um dos seguintes é verdadeiro:
  • O parâmetro lpwsInterfaceName é NULL ou é maior que MAX_INTERFACE_NAME_LEN.
  • Pelo menos um dos parâmetros lpwsUserName, lpwsPassword e lpwsDomainName é muito longo e, portanto, inválido. Consulte a seção Comentários para obter mais informações.
ERROR_NOT_ENOUGH_MEMORY
 Memória insuficiente para criar uma nova estrutura de dados para conter as credenciais.
Outros
 Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.
 
 

Comentários

Os parâmetros lpwsUserName, lpwsPassword e lpwsDomainName são opcionais. Se o aplicativo de chamada especificar NULL para todos os três parâmetros, MprAdminInterfaceSetCredentials removerá todas as informações de credencial para essa interface.

As constantes UNLEN, PWLEN e DNLEN são os comprimentos máximos para o nome de usuário, senha e nome de domínio. Essas constantes são definidas em Lmcons.h.

Observe que a ordem dos parâmetros em MprAdminInterfaceSetCredentials é diferente de MprAdminInterfaceGetCredentials.

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

FormatMessage

MprAdminInterfaceGetCredentials

MprAdminInterfaceGetInfo

Funções de administração do roteador

Referência de gerenciamento de roteador