Funzione EapHostPeerGetMethodProperties (eaphostpeerconfigapis.h)

La funzione EapHostPeerGetMethodProperties viene usata per recuperare le proprietà di un metodo EAP in base ai dati di connessione e utente.

Sintassi

DWORD EapHostPeerGetMethodProperties(
  [in]  DWORD                     dwVersion,
  [in]  DWORD                     dwFlags,
  [in]  EAP_METHOD_TYPE           eapMethodType,
  [in]  HANDLE                    hUserImpersonationToken,
  [in]  DWORD                     dwEapConnDataSize,
  [in]  const BYTE                *pbEapConnData,
  [in]  DWORD                     dwUserDataSize,
  [in]  const BYTE                *pbUserData,
  [out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
  [out] EAP_ERROR                 **ppEapError
);

Parametri

[in] dwVersion

Numero di versione dell'API. Impostare questo parametro su zero.

[in] dwFlags

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

[in] eapMethodType

Una struttura EAP_METHOD_TYPE che specifica il metodo EAP da usare.

[in] hUserImpersonationToken

Handle per il token di rappresentazione utente da usare in questa sessione.

[in] dwEapConnDataSize

Dimensioni, in byte, del buffer dati di connessione fornito in pbEapConnData.

[in] pbEapConnData

Dati di connessione usati per il metodo EAP. Se impostato su NULL, viene restituita la proprietà statica del metodo, come configurato nel Registro di sistema.

[in] dwUserDataSize

Dimensioni, in byte, del buffer dati utente fornito in pbUserData.

[in] pbUserData

Puntatore a un buffer di byte contenente il BLOB dati utente opaco. Questo parametro può essere NULL.

[out] pMethodPropertyArray

Puntatore alla matrice di proprietà del metodo EAP_METHOD_PROPERTY_ARRAY. Il chiamante deve liberare i puntatori interni usando EapHostPeerFreeMemory a partire dal puntatore più interno. Il chiamante deve liberare un valore empvString solo quando il tipo è empvtString.

[out] ppEapError

Puntatore a un puntatore a una struttura EAP_ERROR che contiene eventuali errori generati da EAPHost durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata passando un puntatore a EapHostPeerFreeErrorMemory.

Valore restituito

nessuno

Osservazioni

EapHostPeerGetMethodProperties consente all'utente di recuperare le proprietà di un metodo EAP tramite l'interfaccia supplicant di EAPHost. Le proprietà restituite da questa API possono essere diverse dalle proprietà restituite dalla funzione EapHostPeerGetMethods . La funzione EapHostPeerGetMethodProperties restituisce le proprietà di un metodo EAP per una connessione e dati utente specifici.

Requisiti

Vedi anche

Funzioni di configurazione supplicant di EAPHost