Función RasGetConnectStatusA (ras.h)

Artículo
03/05/2024

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 de 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 RASCONNSTATUS que, en la salida, recibe la información de estado.

En la entrada, establezca el miembro dwSize 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 Enrutamiento y códigos de error de acceso remoto o Winerror.h.

Valor	Significado
ERROR_NOT_ENOUGH_MEMORY	La función no pudo asignar memoria suficiente para completar la operación.

Comentarios

El valor devuelto de RasGetConnectStatus no es necesariamente igual al valor del miembro dwError de la estructura RASCONNSTATUS devuelta por RasGetConnectStatus. El valor devuelto de RasGetConnectStatus indica errores que se producen durante la llamada a la función RasGetConnectStatus , mientras que el miembro dwError indica errores que impedían que se estableciera 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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