Função RasGetAutodialParamA (ras.h)

  • Artigo

A função RasGetAutodialParam recupera o valor de um parâmetro AutoDial.

Sintaxe

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

Parâmetros

[in] unnamedParam1

Especifica o parâmetro AutoDial a ser recuperado. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
RASADP_DisableConnectionQuery
 O parâmetro lpvValue retorna um valor DWORD . Se esse valor for zero (o padrão), o AutoDial exibirá uma caixa de diálogo para consultar o usuário antes de criar uma conexão. Se esse valor for 1 e o banco de dados do AutoDial tiver a entrada do catálogo telefônico para discar, o AutoDial criará uma conexão sem exibir a caixa de diálogo.
RASADP_LoginSessionDisable
 O parâmetro lpvValue retorna um valor DWORD . Se esse valor for 1, o sistema desabilita todas as conexões do AutoDial para a sessão de logon atual. Se esse valor for zero (o padrão), as conexões do AutoDial serão habilitadas. O serviço do sistema do AutoDial altera esse valor para zero quando um novo usuário faz logon na estação de trabalho.
RASADP_SavedAddressesLimit
 O parâmetro lpvValue retorna um valor DWORD que indica o número máximo de endereços que o AutoDial armazena no registro. O AutoDial primeiro armazena os endereços usados para criar uma conexão do AutoDial; em seguida, armazena endereços que aprendeu depois que uma conexão RAS foi criada. Os endereços gravados usando a função RasSetAutodialAddress são sempre salvos e não estão incluídos no cálculo do limite. O valor padrão é 100.
RASADP_FailedConnectionTimeout
 O parâmetro lpvValue retorna um valor DWORD que indica um valor de tempo limite, em segundos. Quando uma tentativa de conexão do AutoDial falha, o serviço de sistema do AutoDial desabilita as tentativas subsequentes de alcançar o mesmo endereço para o período de tempo limite. Isso impede que o AutoDial exiba várias caixas de diálogo de conexão para a mesma solicitação lógica por um aplicativo. O valor padrão é 5.
RASADP_ConnectionQueryTimeout
 O parâmetro lpvValue aponta para um valor DWORD que indica um valor de tempo limite, em segundos. Antes de tentar uma conexão do AutoDial, o sistema exibirá uma caixa de diálogo solicitando que o usuário confirme se o sistema deve discar. A caixa de diálogo tem um temporizador de contagem regressiva que encerra a caixa de diálogo com uma seleção "Não discar" se o usuário não executar nenhuma ação. O valor DWORD apontado por lpvValue especifica a hora inicial neste temporizador de contagem regressiva.

[out] unnamedParam2

Ponteiro para um buffer que recebe o valor do parâmetro especificado.

[in, out] unnamedParam3

Ponteiro para um valor DWORD .

Na entrada, defina esse valor para indicar o tamanho, em bytes, do buffer lpvValue .

Na saída, esse valor indica o tamanho real do valor gravado no buffer.

Retornar valor

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

Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.

Valor Significado
ERROR_INVALID_PARAMETER
 O parâmetro dwKey ou lpvValue é inválido.
ERROR_INVALID_SIZE
 O tamanho especificado pelo lpdwcbValue é muito pequeno.

Comentários

Observação

O cabeçalho ras.h define RasGetAutodialParam como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ras.h
Biblioteca Rasapi32.lib
DLL Rasapi32.dll

Confira também

RasSetAutodialAddress

RasSetAutodialParam

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto