EapPeerGetConfigBlobAndUserBlob-Funktion (eapmethodpeerapis.h)

Die EapPeerGetConfigBlobAndUserBlob-Methode ermöglicht es EAP-Methodenentwicklern, die verschiedenen Verbindungseigenschaften und Benutzereigenschaften bereitzustellen, die von der -Methode unterstützt werden. EAPHost ruft diese Funktion auf, um die Verbindungseigenschaft und die Benutzereigenschaft der EAP-Methode zu erstellen.

Syntax

DWORD EapPeerGetConfigBlobAndUserBlob(
  [in]  DWORD           dwFlags,
  [in]  EAP_METHOD_TYPE eapMethodType,
  [in]  EapCredential   eapCredential,
  [out] DWORD           *pdwConfigBlobSize,
  [out] BYTE            **ppConfigBlob,
  [out] DWORD           *pdwUserBlobSize,
  [out] BYTE            **ppUserBlob,
  [out] EAP_ERROR       **ppEapError
);

Parameter

[in] dwFlags

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

[in] eapMethodType

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

[in] eapCredential

Eine EapCredential-Struktur , die den Anmeldeinformationstyp und die entsprechenden Anmeldeinformationen enthält.

[out] pdwConfigBlobSize

Empfängt einen Zeiger auf die Größe des ppConfigBlob-Parameters in Bytes.

[out] ppConfigBlob

Empfängt einen Zeiger auf einen Zeiger, der einen Bytepuffer mit konfigurierten Verbindungsdaten enthält.

[out] pdwUserBlobSize

Empfängt einen Zeiger auf die Größe des ppUserBlob-Parameters in Bytes.

[out] ppUserBlob

Empfängt einen Zeiger auf einen Zeiger, der einen Bytepuffer mit den Benutzerdaten der Methoden enthält.

[out] ppEapError

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

Rückgabewert

Diese Funktion sollte ERROR_SUCCESS zurückgeben, wenn sie die richtige Verbindung und das richtige Benutzerblob generieren kann. In allen anderen Fällen wird der entsprechende Windows-Fehler zurückgegeben.

Hinweise

Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die von EAPHost geladene EAP-Methode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile eapmethodpeerapis.h
DLL Eappcfg.dll

Weitere Informationen

EAP-Flags

EAP_ERROR

EAP_METHOD_TYPE

EapCredential

EapPeerFreeErrorMemory