Share via

RasGetNapStatus-Funktion (ras.h)

  • Artikel

Die RasGetNapStatus-Funktion ruft die NAP-Verbindungszustandsvariablen ( Network Access Protection ) für eine bestimmte RAS-Verbindung ab.

Syntax

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

Parameter

[in] hRasconn

Ein Handle für die Verbindung. Verwenden Sie RasDial oder RasEnumConnections , um dieses Handle abzurufen.

[in, out] pRasNapState

Ein Zeiger auf eine RASNAPSTATE-Struktur . Bei der Eingabe muss das dwSize-Element der Struktur auf sizeof(RASNAPSTATE) festgelegt werden. Bei der Ausgabe gibt pNapState den NAP-Zustand der RAS-Verbindung zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.

Rückgabecode Beschreibung
ERROR_NOT_NAP_CAPABLE
 Die Verbindung, die dem hRasConn-Parameter entspricht, ist nicht für NAP konfiguriert.
ERROR_INVALID_SIZE
 Der dwSize-Parameter der RASNAPSTATE-Struktur weist einen ungültigen Größenwert auf.
ERROR_INVALID_HANDLE
 Das an die Funktion übergebene Handle ist entweder NULL oder ungültig.
ERROR_NO_CONNECTION
 RASMAN konnte das Handle in der Liste der Handles nicht finden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ras.h
Bibliothek Rasapi32.lib
DLL Rasapi32.dll