Compartir a través de

Función RasGetNapStatus (ras.h)

  • Artículo

La función RasGetNapStatus recupera las variables de estado de conexión de Protección de acceso a redes (NAP) para una conexión de acceso remoto determinada.

Sintaxis

DWORD RasGetNapStatus(
  [in]      HRASCONN      hRasconn,
  [in, out] LPRASNAPSTATE pRasNapState
);

Parámetros

[in] hRasconn

Identificador de la conexión. Use RasDial o RasEnumConnections para obtener este identificador.

[in, out] pRasNapState

Puntero a una estructura RASNAPSTATE . En la entrada, el miembro dwSize de la estructura debe establecerse en sizeof(RASNAPSTATE). En la salida, pNapState devuelve el estado NAP de la conexión RAS.

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 uno de los siguientes códigos de error o un valor de Códigos de error de enrutamiento y acceso remoto o Winerror.h.

Código devuelto Descripción
ERROR_NOT_NAP_CAPABLE
 La conexión correspondiente al parámetro hRasConn no está configurada para NAP.
ERROR_INVALID_SIZE
 El parámetro dwSize de la estructura RASNAPSTATE tiene un valor de tamaño no válido.
ERROR_INVALID_HANDLE
 El identificador pasado a la función es NULL o no es válido.
ERROR_NO_CONNECTION
 RASMAN no encontró el identificador en su lista de identificadores.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ras.h
Library Rasapi32.lib
Archivo DLL Rasapi32.dll