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

Artículo
08/25/2023

La función RasDialFunc2 llama a una función de devolución de llamada rasDial cuando se produce un cambio de estado durante un proceso de conexión de acceso remoto. Una función RasDialFunc2 es similar a la función de devolución de llamada RasDialFunc1 , salvo que proporciona información adicional para las conexiones de varios vínculos.

Sintaxis

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

Parámetros

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

Valor devuelto

Si la función RasDialFunc2 devuelve un valor distinto de cero, RasDial continúa enviando notificaciones de devolución de llamada.

Si la función RasDialFunc2 devuelve cero, RasDial deja de enviar notificaciones de devolución de llamada para todos los subentries.

Comentarios

Una operación de conexión RasDial se suspende durante una llamada a una función de devolución de llamada RasDialFunc2 . Por ese motivo, la implementación de RasDialFunc2 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 RasDialFunc2 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 rasDialFunc2 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 RasDialFunc2 . 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.

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

NotaRasDialFunc2 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