Función RasConnectionNotificationA (ras.h)

  • Artículo

La función RasConnectionNotification especifica un objeto de evento que el sistema establece en el estado señalado cuando se crea o finaliza una conexión RAS.

Sintaxis

DWORD RasConnectionNotificationA(
  [in] HRASCONN unnamedParam1,
  [in] HANDLE   unnamedParam2,
  [in] DWORD    unnamedParam3
);

Parámetros

[in] unnamedParam1

Identificador de la conexión RAS que recibe las notificaciones. Puede ser un identificador devuelto por la función RasDial o RasEnumConnections . Si este parámetro es INVALID_HANDLE_VALUE, se reciben notificaciones para todas las conexiones RAS en el cliente local.

[in] unnamedParam2

Especifica el identificador de un objeto de evento. Use la función CreateEvent para crear un objeto de evento.

[in] unnamedParam3

Especifica el evento RAS que hace que el sistema señale el objeto de evento especificado por el parámetro hEvent . Este parámetro es una combinación de los valores siguientes.

Valor Significado
RASCN_Connection
 Si hrasconn es INVALID_HANDLE_VALUE, se señala hEvent cuando se crea cualquier conexión RAS.
RASCN_Disconnection
 hEvent se señala cuando finaliza la conexión hrasconn . Si hrasconn es una conexión de varios vínculos, el evento se señala cuando se desconectan todas las subintentos. Si hrasconn es INVALID_HANDLE_VALUE, el evento se señala cuando se finaliza cualquier conexión RAS.
RASCN_BandwidthAdded
 Windows NT: Si hrasconn es un identificador de una conexión multilink combinada, hEvent se señala cuando se conecta un subentry.
RASCN_BandwidthRemoved
 Windows NT: Si hrasconn es un identificador de una conexión combinada de varios vínculos, hEvent se señala cuando se desconecta un subentry.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error distinto de cero de códigos de error de enrutamiento y acceso remoto o Winerror.h.

Comentarios

Para determinar cuándo se señala el objeto de evento, use cualquiera de las funciones de espera.

Cuando se señaliza el evento, use otras funciones RAS, como RasEnumConnections, para obtener más información sobre la conexión RAS que se creó o finalizó.

Nota

El encabezado ras.h define RasConnectionNotification 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
Library Rasapi32.lib
Archivo DLL Rasapi32.dll

Consulte también

CreateEvent

RasEnumConnections

Información general sobre el servicio de acceso remoto (RAS)

Funciones del Servicio de acceso remoto