Función de devolución de llamada RASADFUNCA (ras.h)

Artículo
08/25/2023

La función RASADFunc es una función de devolución de llamada definida por la aplicación que se usa para proporcionar una interfaz de usuario personalizada para el diagnóstico automático.

Sintaxis

RASADFUNCA Rasadfunca;

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

Parámetros

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Valor devuelto

Si la aplicación realiza la operación de marcado, devuelva TRUE. Use el parámetro lpdwRetCode para indicar los resultados de la operación de marcado.

Si la aplicación no realiza la operación de marcado, devuelva FALSE. En este caso, el sistema usa la interfaz de usuario predeterminada para marcar.

Comentarios

Cuando el sistema inicia una operación AutoDial para una entrada de libreta de teléfonos con un controlador AutoDial personalizado, llama al RASADFunc especificado. RASADFunc puede iniciar un subproceso para realizar la operación de marcado personalizado. La función RASADFunc devuelve TRUE para indicar que tomó el marcado o FALSE para permitir que el sistema realice la marcación.

Si la función RASADFunc realiza la operación de marcado, presenta su propia interfaz de usuario para marcar y llama a la función RasDial para realizar la marcación real. A continuación, RASADFunc devuelve TRUE para indicar que tomó el marcado. Cuando se haya completado la operación de marcado, establezca la variable a la que apunta el parámetro lpdwRetCode para indicar el éxito o el error.

El ARCHIVO DLL AutoDial debe proporcionar tanto una RASADFUNCA (ANSI) como una versión RASADFUNCW (Unicode) del controlador RASADFunc . Para habilitar un controlador AutoDial RASADFunc para una entrada de libreta de teléfonos, use la estructura RASENTRY en una llamada a la función RasSetEntryProperties . El miembro szAutodialDll especifica el nombre del archivo DLL que contiene el controlador y el miembro szAutodialFunc especifica el nombre exportado del controlador. El miembro szAutodialFunc no debe incluir el sufijo "A" o "W".

RASADFunc es un marcador de posición para el nombre de función definido por la biblioteca. El tipo RASADFUNC es un puntero a una función RASADFunc .

Nota

El encabezado ras.h define RASADFUNC como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ras.h