Funzione EapPeerGetIdentity (eapmethodpeerapis.h)

Restituisce i dati utente e l'identità utente dopo essere chiamata da EAPHost.

Sintassi

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [in]      DWORD      dwSizeofConnectionData,
  [in]      const BYTE *pConnectionData,
  [in]      DWORD      dwSizeofUserData,
  [in]      const BYTE *pUserData,
  [in]      HANDLE     hTokenImpersonateUser,
  [out]     BOOL       *pfInvokeUI,
  [in, out] DWORD      *pdwSizeOfUserDataOut,
  [out]     BYTE       **ppUserDataOut,
  [out]     LPWSTR     *ppwszIdentity,
  [out]     EAP_ERROR  **ppEapError
);

Parametri

[in] dwFlags

Combinazione di flag EAP che descrivono il comportamento della sessione di autenticazione EAP.

[in] dwSizeofConnectionData

Specifica le dimensioni, in byte, del buffer dati di connessione fornito in pConnectionData

[in] pConnectionData

Puntatore a un buffer di byte che contiene il BLOB dati di configurazione opaco.

[in] dwSizeofUserData

Specifica le dimensioni, in byte, del buffer dati utente fornito in pUserData.

[in] pUserData

Puntatore ai dati utente specifici di questa autenticazione usata per precompilare i dati utente. Quando questa API viene chiamata per la prima volta o quando viene avviata una nuova sessione di autenticazione, questo parametro è NULL. In caso contrario, impostare questo parametro sul membro pUserData della struttura a cui punta il parametro ppResult ricevuto da EapPeerGetResult.

[in] hTokenImpersonateUser

Specifica un handle per il token di rappresentazione dell'utente autenticato. Questo handle sarà NULL quando si esegue l'autenticazione del computer. Usando questo handle un metodo EAP può rappresentare l'utente per ottenere informazioni specifiche dell'utente, ad esempio nome utente, nome di dominio e credenziali.

[out] pfInvokeUI

Restituisce TRUE se il BLOB di dati utente e identità utente non viene restituito correttamente e il metodo cerca di raccogliere le informazioni dall'utente tramite la finestra di dialogo dell'interfaccia utente.

[in, out] pdwSizeOfUserDataOut

Specifica le dimensioni, in byte, del buffer ppUserDataOut .

[out] ppUserDataOut

Puntatore a un puntatore ai dati utente restituiti. I dati vengono passati a EapPeerBeginSession come input pUserData.

[out] ppwszIdentity

Puntatore all'identità utente restituita. Il puntatore verrà incluso nel pacchetto di risposta identity e restituito al server.

[out] ppEapError

Puntatore al puntatore a una struttura EAP_ERROR contenente eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata chiamando EapPeerFreeErrorMemory.

Valore restituito

nessuno

Osservazioni

Questa chiamata viene eseguita da un EAPHost basato su peer usando un puntatore di funzione a questa API. Questa API deve essere implementata nel metodo EAP caricato da EAPHost e deve essere strettamente conforme ai tipi di sintassi e di parametri specificati nella documentazione.

Requisiti

Vedi anche

Metodo peer EAPHost Run-Time Funzioni

EapPeerInvokeIdentityUI