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

Artigo
11/20/2024

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 de retorno

Se o aplicativo executar a operação de discagem, retorne VERDADEIRO. 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.

Observações

Quando o sistema inicia uma operação do AutoDial para uma entrada de lista telefônica 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. O RASADFunc retorna TRUE para indicar que 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 um RASADFUNCA (ANSI) e uma versão RASADFUNCW (Unicode) do manipulador de RASADFunc. Para habilitar um manipulador RASADFunc AutoDial para uma entrada de lista telefônica, use a estrutura de 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 de RASADFUNC é um ponteiro para uma função RASADFunc.

Nota

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 do 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

Consulte também

RASENTRY

RasDial

rasSetEntryProperties

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

Funções do Serviço de Acesso Remoto

Compartilhar via