Funzione EapHostPeerGetAuthStatus (eappapis.h)

Ottiene lo stato di autenticazione EAP corrente del supplicante da EAPHost.

Sintassi

DWORD EapHostPeerGetAuthStatus(
  [in]  EAP_SESSIONID         sessionHandle,
  [in]  EapHostPeerAuthParams authParam,
  [out] DWORD                 *pcbAuthData,
  [out] BYTE                  **ppAuthData,
  [out] EAP_ERROR             **ppEapError
);

Parametri

[in] sessionHandle

Puntatore a una struttura di EAP_SESSIONID che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost. Questo handle viene restituito nel parametro pSessionId in una chiamata precedente a EapHostPeerBeginSession.

[in] authParam

Valore di enumerazione EapHostPeerAuthParams che specifica il tipo di dati di autenticazione EAP da ottenere da EAPHost.

Valore Significato
EapHostPeerAuthStatus
ppAuthData contiene una struttura EAPHOST_AUTH_INFO .
EapHostPeerIdentity
ppAuthData contiene un buffer WCHAR .
EapHostPeerIdentityExtendedInfo
ppAuthData contiene un buffer CHAR .
EapHostNapInfo
Windows 7 o versione successiva: struttura [EapHostPeerNapInfo](/windows/win32/eaphost/eaphostpeernapinfo).

[out] pcbAuthData

Dimensioni, in byte, del buffer dei dati di autenticazione EAP a cui punta il parametro ppAuthData .

[out] ppAuthData

Puntatore a un puntatore a un buffer di byte che contiene i dati di autenticazione da EAPHost. Il formato di questi dati dipende dal valore specificato in authParam.

[out] ppEapError

Puntatore all'indirizzo di una struttura EAP_ERROR . L'indirizzo deve essere impostato su NULL prima di chiamare questa funzione. Se sono disponibili dati di errore, viene ricevuto un puntatore all'indirizzo di una struttura di EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver usato i dati di errore, liberare questa memoria chiamando EapHostPeerFreeEapError.

Valore restituito

nessuno

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione eappapis.h
Libreria Eappprxy.lib
DLL Eappprxy.dll

Vedi anche

Funzioni di Run-Time supplicant di EAPHost