Função RasGetAutodialParamA (ras.h)

Artigo
11/20/2024

A função RasGetAutodialParam recupera o valor de um parâmetro do 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 ser um dos valores a seguir.

Valor	Significado
RASADP_DisableConnectionQuery	O parâmetro lpvValue retorna um valor de 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 da lista telefônica para discar, o AutoDial criará uma conexão sem exibir a caixa de diálogo.
RASADP_LoginSessionDisable	O parâmetro lpvValue retorna um valor de 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 os endereços que aprendeu depois que uma conexão RAS foi criada. 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 de 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 durante 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 tomar nenhuma ação. O valor de 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.

Valor de retorno

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.

Observações

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ras.h
biblioteca	Rasapi32.lib
de DLL	Rasapi32.dll

Consulte também

RasSetAutodialAddress

rasSetAutodialParam

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

Funções do Serviço de Acesso Remoto

Compartilhar via