Función RasGetConnectStatusA (ras.h)
La función RasGetConnectStatus recupera información sobre el estado actual de la conexión de acceso remoto especificada. Una aplicación puede usar esta llamada para determinar cuándo se completa una llamada asincrónica RasDial.
Sintaxis
DWORD RasGetConnectStatusA(
[in] HRASCONN unnamedParam1,
[in, out] LPRASCONNSTATUSA unnamedParam2
);
Parámetros
[in] unnamedParam1
Especifica la conexión de acceso remoto para la que se va a recuperar el estado. Este identificador debe haberse obtenido de RasDial o RasEnumConnections.
[in, out] unnamedParam2
Puntero a la estructura de RASCONNSTATUS que, en la salida, recibe la información de estado.
En la entrada, establezca el dwSize miembro de la estructura en sizeof(RASCONNSTATUS) para identificar la versión de la estructura que se pasa.
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 uno de los siguientes códigos de error o un valor de Códigos de error de enrutamiento y acceso remoto o Winerror.h.
| Valor | Significado |
|---|---|
|
La función no pudo asignar suficiente memoria para completar la operación. |
Observaciones
El valor devuelto de rasGetConnectStatus no es necesariamente igual al valor del miembro dwError de la estructura de RASCONNSTATUS devuelta por RasGetConnectStatus. El valor devuelto de RasGetConnectStatus indica errores que se producen durante la llamada de función RasGetConnectStatus, mientras que el miembro dwError indica errores que impiden que se establezca la conexión.
Nota
El encabezado ras.h define RasGetConnectStatus 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 |