Función RasConnectionNotificationA (ras.h)

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 de 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 indique el objeto de evento especificado por el parámetro hEvent. Este parámetro es una combinación de los siguientes valores.

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 de . Si hrasconn es una conexión de varios vínculos, el evento se indica 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 combinada de varios vínculos, hEvent se indica cuando se conecta un subentry.
RASCN_BandwidthRemoved	Windows NT: Si hrasconn es un identificador de una conexión combinada de varios vínculos, se indica hEvent cuando se desconecta un subentry.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es 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.

Observaciones

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

Cuando se señale 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 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
biblioteca de	Rasapi32.lib
DLL de	Rasapi32.dll

Consulte también

CreateEvent

RasEnumConnections

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

funciones del servicio de acceso remoto