Fonction RasGetNapStatus (ras.h)

  • Article

La fonction RasGetNapStatus récupère les variables d’état de connexion NAP ( Network Access Protection ) pour une connexion d’accès à distance donnée.

Syntaxe

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

Paramètres

[in] hRasconn

Handle de la connexion. Utilisez RasDial ou RasEnumConnections pour obtenir ce handle.

[in, out] pRasNapState

Pointeur vers une structure RASNAPSTATE . En entrée, le membre dwSize de la structure doit être défini sur sizeof(RASNAPSTATE). À la sortie, pNapState retourne l’état NAP de la connexion RAS.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur provenant des codes d’erreur de routage et d’accès à distance ou de Winerror.h.

Code de retour Description
ERROR_NOT_NAP_CAPABLE
 La connexion correspondant au paramètre hRasConn n’est pas configurée pour NAP.
ERROR_INVALID_SIZE
 Le paramètre dwSize de la structure RASNAPSTATE a une valeur de taille non valide.
ERROR_INVALID_HANDLE
 Le handle passé à la fonction est NULL ou non valide.
ERROR_NO_CONNECTION
 RASMAN n’a pas trouvé le handle dans sa liste de handles.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ras.h
Bibliothèque Rasapi32.lib
DLL Rasapi32.dll