EapMethodAuthenticatorInvokeConfigUI-Funktion (eapmethodauthenticatorapis.h)

Definiert eine Funktion, die das Dialogfeld für die Benutzeroberfläche für die Verbindungskonfiguration der EAP-Methode auf dem Client auslöst.

EapMethodAuthenticatorInvokeConfigUI ist ein Funktionsprototyp.

EapHostAuthenticatorInvokeConfigUI muss für Threads aufgerufen werden, die COM für Single Threaded Apartment initialisiert haben. Dies kann durch Aufrufen der COM-API CoInitialize erreicht werden. wenn der Supplicant mit dem STA-Thread CoUninitialize beendet wurde, muss vor dem Beenden aufgerufen werden.

Syntax

DWORD EapMethodAuthenticatorInvokeConfigUI(
  [in]  EAP_METHOD_TYPE *pEapMethodType,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwFlags,
  [in]  LPCWSTR         pwszMachineName,
  [in]  DWORD           dwSizeOfConfigIn,
  [in]  BYTE            *pConfigIn,
  [out] DWORD           *pdwSizeOfConfigOut,
  [out] BYTE            **ppConfigOut,
  [out] EAP_ERROR       **ppEapError
);

Parameter

[in] pEapMethodType

Ein Zeiger auf eine EAP_METHOD_TYPE-Struktur , die Anbieter- und Autoreninformationen zur EAP-Methode enthält, die für die Authentifizierung der Verbindung verwendet wird.

[in] hwndParent

Ein Handle für das übergeordnete Fenster, das das Dialogfeld für die Benutzeroberfläche der Verbindungskonfiguration startet.

[in] dwFlags

Eine Kombination aus EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.

[in] pwszMachineName

Der Name des Zielcomputers, der konfiguriert wird. NULL bedeutet, dass der lokale Computer konfiguriert wird.

[in] dwSizeOfConfigIn

Gibt die Größe von pConfigIn in Bytes an. Kann auf 0 festgelegt werden.

[in] pConfigIn

Ein Zeiger auf einen Bytepuffer, der Konfigurationselemente enthält. Der Puffer hat die Größe dwSizeOfConfigIn. Dieser Parameter kann NULL sein, wenn dwSizeOfConfigIn auf 0 festgelegt ist.

[out] pdwSizeOfConfigOut

Gibt die Größe der in ppConfigOut zurückgegebenen Konfigurationsdaten in Bytes an.

[out] ppConfigOut

Ein Zeiger auf einen Zeiger auf einen Bytepuffer, der aktualisierte Konfigurationsdaten vom Benutzer enthält. Nach der Nutzung der Daten muss dieser Arbeitsspeicher freigegeben werden, indem EapMethodAuthenticatorFreeMemory aufgerufen wird.

[out] ppEapError

Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem EapMethodAuthenticatorFreeErrorMemory aufgerufen wird.

Rückgabewert

Keine

Anforderungen

Weitere Informationen

EAPHost Authenticator-Methodenfunktionen