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

Artículo
03/01/2024

La función RasDialFunc llama a la función de devolución de llamada RasDial cuando se produce un cambio de estado durante un proceso de conexión RAS.

Sintaxis

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

Parámetros

unnamedParam1

unnamedParam2

unnamedParam3

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 RasDialFunc . Por ese motivo, la implementación de RasDialFunc suele devolverse lo antes 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 RasDialFunc no suele ser un problema. El requisito de devolución del símbolo del sistema 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 de RasDialFunc no debe depender del orden o 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 RasDialFunc . Llame a las funciones RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString y RasHangUp desde dentro de la función de devolución de llamada. Por ejemplo, llamar a RasGetConnectStatus desde dentro de una función de devolución de llamada sería útil para determinar el nombre y el tipo del dispositivo que se conecta.

Nota Para mayor comodidad, se puede llamar a RasHangUp desde una función de devolución de llamada RasDialFunc . 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 RasDialFunc .

NotaRasDialFunc es un marcador de posición para el nombre de función definido por la aplicación o definido por 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