Função MprAdminInterfaceGetCredentials (mprapi.h)
Use a função MprAdminInterfaceGetCredentials para recuperar o domínio, o nome de usuário e a senha para discar na interface de discagem de demanda especificada.
Sintaxe
DWORD MprAdminInterfaceGetCredentials(
[in] LPWSTR lpwsServer,
[in] LPWSTR lpwsInterfaceName,
[out] LPWSTR lpwsUserName,
[out] LPWSTR lpwsPassword,
[out] LPWSTR lpwsDomainName
);
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.
[out] lpwsUserName
Ponteiro para uma cadeia de caracteres Unicode que recebe o nome do usuário. Essa cadeia de caracteres deve ter menos de 1 comprimento.
Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não retornará o nome de usuário.
[out] lpwsPassword
Ponteiro para uma cadeia de caracteres Unicode que recebe a senha. Essa cadeia de caracteres deve ter PWLEN+1 de comprimento.
Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não retornará a senha.
[out] lpwsDomainName
Ponteiro para uma cadeia de caracteres Unicode que recebe o nome de domínio. Essa cadeia de caracteres deve ter DNLEN+1 de comprimento.
Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não retornará o nome de domínio.
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 seguintes códigos de erro.
| Valor | Significado |
|---|---|
|
A interface especificada não tem parâmetros de discagem de demanda associados a ela. |
|
O parâmetro lpwsInterfaceName é NULL. |
|
Os parâmetros lpwsUserName, lpwsPassword e lpwsDomainName são todos NULL. |
|
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, MprAdminInterfaceGetCredentials retornará NO_ERROR e o domínio, o nome de usuário e a senha não serão retornados.
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 MprAdminInterfaceGetCredentials é diferente de MprAdminInterfaceSetCredentials.
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
MprAdminInterfaceSetCredentials