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

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

Observaciones

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. El 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, el RASADFunc devuelve TRUE para indicar que tomó el control de marcado. Cuando se haya completado la operación de marcado, establezca la variable a la que apunta el parámetro lpdwRetCode para indicar éxito o error.

El ARCHIVO DLL autoDial debe proporcionar tanto una RASADFUNCA (ANSI) como una RASADFUNCW (Unicode) del controlador de RASADFunc. Para habilitar un controlador AutoDial de RASADFunc para una entrada de libreta de teléfonos, use la estructura de RASENTRY de 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 de 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	ras.h

Consulte también

RASENTRY

RasDial

RasSetEntryProperties

información general del servicio de acceso remoto (RAS)

funciones del servicio de acceso remoto