Função de retorno de chamada RASADFUNCA (ras.h)

Artigo
03/15/2023

A função RASADFunc é uma função de retorno de chamada definida pelo aplicativo que é usada para fornecer uma interface do usuário personalizada para o preenchimento automático.

Sintaxe

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

Parâmetros

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Valor retornado

Se o aplicativo executar a operação de discagem, retorne TRUE. Use o parâmetro lpdwRetCode para indicar os resultados da operação de discagem.

Se o aplicativo não executar a operação de discagem, retorne FALSE. Nesse caso, o sistema usa a interface do usuário padrão para discagem.

Comentários

Quando o sistema inicia uma operação do AutoDial para uma entrada de catálogo telefônico com um manipulador de AutoDial personalizado, ele chama o RASADFunc especificado. O RASADFunc pode iniciar um thread para executar a operação de discagem personalizada. A função RASADFunc retorna TRUE para indicar que assumiu a discagem ou FALSE para permitir que o sistema executasse a discagem.

Se a função RASADFunc executar a operação de discagem, ela apresentará sua própria interface do usuário para discagem e chamará a função RasDial para fazer a discagem real. Em seguida, o RASADFunc retorna TRUE para indicar que ele assumiu a discagem. Quando a operação de discagem tiver sido concluída, defina a variável apontada pelo parâmetro lpdwRetCode para indicar êxito ou falha.

A DLL do AutoDial deve fornecer uma RASADFUNCA (ANSI) e uma versão RASADFUNCW (Unicode) do manipulador RASADFunc . Para habilitar um manipulador de AutoDial RASADFunc para uma entrada de catálogo telefônico, use a estrutura RASENTRY em uma chamada para a função RasSetEntryProperties . O membro szAutodialDll especifica o nome da DLL que contém o manipulador e o membro szAutodialFunc especifica o nome exportado do manipulador. O membro szAutodialFunc não deve incluir o sufixo "A" ou "W".

RASADFunc é um espaço reservado para o nome da função definida pela biblioteca. O tipo RASADFUNC é um ponteiro para uma função RASADFunc .

Observação

O cabeçalho ras.h define RASADFUNC 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