Funzione RasGetNapStatus (ras.h)

  • Articolo

La funzione RasGetNapStatus recupera le variabili di stato di connessione protezione accesso alla rete per una determinata connessione di accesso remoto.

Sintassi

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

Parametri

[in] hRasconn

Handle per la connessione. Usare RasDial o RasEnumConnections per ottenere questo handle.

[in, out] pRasNapState

Puntatore a una struttura RASNAPSTATE . In input, il membro dwSize della struttura deve essere impostato su sizeof(RASNAPSTATE). Nell'output , pNapState restituisce lo stato NAP della connessione RAS.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Routing e Remote Access Error Codes o Winerror.h.

Codice restituito Descrizione
ERROR_NOT_NAP_CAPABLE
 La connessione corrispondente al parametro hRasConn non è configurata per Protezione accesso alla rete.
ERROR_INVALID_SIZE
 Il parametro dwSize della struttura RASNAPSTATE ha un valore di dimensione non valido.
ERROR_INVALID_HANDLE
 Handle passato alla funzione è NULL o non valido.
ERROR_NO_CONNECTION
 RASMAN non è riuscito a trovare l'handle nell'elenco di handle.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ras.h
Libreria Rasapi32.lib
DLL Rasapi32.dll