RASDIALFUNC1 función de devolución de llamada (ras.h)

Artículo
03/15/2023

La función RasDialFunc1 llama a una función RasDial cuando se produce un cambio de estado durante un proceso de conexión de acceso remoto. Una función RasDialFunc1 es comparable a una función RasDialFunc , pero se mejora mediante la adición de dos parámetros: un identificador para la conexión RAS y un código de error extendido.

Sintaxis

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Parámetros

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

Valor devuelto

None

Observaciones

Una operación de conexión RasDial se suspende durante una llamada a una función de devolución de llamada RasDialFunc1 . Por ese motivo, la implementación de RasDialFunc1 generalmente devuelve lo más rápido posible. Hay dos excepciones a esa regla. Los dispositivos asincrónicos (lentos), como los módems, suelen tener períodos de tiempo de espera medidos en segundos en lugar de milisegundos; Un retorno lento de una función RasDialFunc1 no suele ser un problema. El requisito de devolución del aviso tampoco se aplica cuando dwError no es cero, lo que indica que se ha producido un error. Por ejemplo, es seguro colocar un cuadro de diálogo de error y esperar la entrada del usuario.

La implementación rasDialFunc1 no debe depender del orden o de la aparición de estados de conexión RASCONNSTATE concretos, ya que esto puede variar entre plataformas.

No llame a la función RasDial desde una función de devolución de llamada RasDialFunc1 . Llame a las funciones RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString y RasHangUp desde la función de devolución de llamada. Por ejemplo, llamar a RasGetConnectStatus desde una función de devolución de llamada sería útil para determinar el nombre y el tipo del dispositivo de conexión.

Tenga en cuenta que, por comodidad, se puede llamar a RasHangUp desde una función de devolución de llamada RasDialFunc1 . Sin embargo, gran parte del procesamiento de bloqueo se produce después de que se haya devuelto la función de devolución de llamada RasDialFunc1 .

RasDialFunc1 es un marcador de posición para el nombre de función definido por la aplicación o la biblioteca.

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