ONEX_EAP_ERROR struttura (dot1x.h)
La struttura ONEX_EAP_ERROR contiene un errore EAP 802.1X quando si verifica un errore con l'autenticazione 802.1X.
Sintassi
typedef struct _ONEX_EAP_ERROR {
DWORD dwWinError;
EAP_METHOD_TYPE type;
DWORD dwReasonCode;
GUID rootCauseGuid;
GUID repairGuid;
GUID helpLinkGuid;
DWORD fRootCauseString : 1;
DWORD fRepairString : 1;
ONEX_VARIABLE_BLOB RootCauseString;
ONEX_VARIABLE_BLOB RepairString;
} ONEX_EAP_ERROR, *PONEX_EAP_ERROR;
Members
dwWinError
Valore di errore definito nel file di intestazione Winerror.h . Questo membro contiene anche il motivo per cui il metodo EAP non è riuscito. I valori esistenti per questo membro per il motivo per cui il metodo EAP non è riuscito sono definiti nel file di intestazione Eaphosterror.h .
Di seguito sono elencati alcuni valori possibili.
type
Tipo di metodo EAP che ha generato l'errore durante l'autenticazione 802.1X. La struttura EAP_METHOD_TYPE è definita nel file di intestazione Eaptypes.h .
dwReasonCode
Motivo per cui il metodo EAP non è riuscito. Alcuni dei valori per questo membro sono definiti nel file di intestazione Eaphosterror.h e alcuni sono definiti nel file di intestazione Winerror.h , anche se sono possibili altri valori.
Di seguito sono elencati i valori possibili.
| Valore | Significato |
|---|---|
|
Uno o più argomenti non sono corretti. |
|
I dati non sono validi. |
|
Un parametro non è corretto. |
|
L'errore EAPHost ricevuto dopo lo scambio di identità. È probabile che si verifichi un problema con l'account dell'utente di autenticazione. |
|
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
rootCauseGuid
ID univoco che identifica la causa dell'errore in EAPHost. Un metodo EAP può definire un nuovo GUID e associare il GUID a una causa radice specifica. I valori esistenti per questo membro sono definiti nel file di intestazione Eaphosterror.h .
repairGuid
ID univoco che esegue il mapping a una stringa localizzata che identifica l'azione di ripristino che può essere eseguita per correggere l'errore segnalato. I valori esistenti per questo membro sono definiti nel file di intestazione Eaphosterror.h .
helpLinkGuid
ID univoco che esegue il mapping a una stringa localizzata che specifica un URL per una pagina contenente informazioni aggiuntive su un errore o un messaggio di ripristino. Un metodo EAP può potenzialmente definire un nuovo GUID e associare un collegamento specifico alla Guida. Alcuni dei valori esistenti per questo membro sono definiti nel file di intestazione Eaphosterror.h .
fRootCauseString
Indica se la struttura ONEX_EAP_ERROR contiene una stringa di causa radice nel membro RootCauseString .
fRepairString
Indica se la struttura ONEX_EAP_ERROR contiene una stringa di ripristino nel membro RepairString .
RootCauseString
Stringa localizzata e leggibile che descrive la causa radice dell'errore. Questo membro contiene una stringa Unicode con terminazione NULL a partire dal membro dwOffset del ONEX_VARIABLE_BLOB se il membro bitfield fRootCauseString è impostato.
RepairString
Stringa localizzata e leggibile che descrive l'azione di ripristino possibile. Questo membro contiene una stringa Unicode con terminazione NULL a partire dal membro dwOffset del ONEX_VARIABLE_BLOB se il membro bitfield fRepairString è impostato.
Commenti
La struttura ONEX_EAP_ERROR viene usata dal modulo 802.1X, un nuovo componente di configurazione wireless supportato in Windows Vista e versioni successive.
Molti membri della struttura ONEX_EAP_ERROR corrispondono a membri simili nella struttura EAP_ERROR
La ONEX_RESULT_UPDATE_DATA contiene informazioni su una modifica dello stato all'autenticazione 802.1X. La struttura ONEX_RESULT_UPDATE_DATA viene restituita quando il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA è WLAN_NOTIFICATION_SOURCE_ONEX e il membro NotificationCodedella struttura WLAN_NOTIFICATION_DATA per la notifica ricevuta è OneXNotificationTypeResultUpdate. Per questa notifica, il membro pData della struttura WLAN_NOTIFICATION_DATA punta a una struttura ONEX_RESULT_UPDATE_DATA che contiene informazioni sulla modifica dello stato di autenticazione 802.1X.
Se il membro fEapError nella struttura ONEX_RESULT_UPDATE_DATA è impostato, il membro eapErrordella struttura ONEX_RESULT_UPDATE_DATA contiene una struttura ONEX_VARIABLE_BLOB con una struttura ONEX_EAP_ERROR incorporata a partire dal membro dwOffset del ONEX_VARIABLE_BLOB.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | dot1x.h |