EapPeerGetMethodProperties-Funktion (eapmethodpeerapis.h)

Definiert die Implementierung einer EAP-methodenspezifischen Funktion, die die Eigenschaften einer EAP-Methode unter Berücksichtigung der Verbindungs- und Benutzerdaten abruft.

Syntax

DWORD EapPeerGetMethodProperties(
  [in]  DWORD                     dwVersion,
  [in]  DWORD                     dwFlags,
  [in]  EAP_METHOD_TYPE           eapMethodType,
  [in]  HANDLE                    hUserImpersonationToken,
  [in]  DWORD                     dwSizeOfConnectionDataIn,
  [in]  const BYTE                *pConnectionDataIn,
  [in]  DWORD                     dwSizeOfUserDataIn,
  [in]  const BYTE                *pUserDataIn,
  [out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
  [out] EAP_ERROR                 **ppEapError
);

Parameter

[in] dwVersion

Die Versionsnummer der API.

[in] dwFlags

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

[in] eapMethodType

Eine EAP_METHOD_TYPE Struktur, die die EAP-Methode identifiziert, die der Supplicant verwenden soll.

[in] hUserImpersonationToken

Ein Handle für das Benutzeridentitätswechseltoken, das in dieser Sitzung verwendet werden soll.

[in] dwSizeOfConnectionDataIn

Die Größe des in pbEapConnData bereitgestellten Verbindungsdatenpuffers in Bytes.

[in] pConnectionDataIn

Verbindungsdaten, die für die EAP-Methode verwendet werden. Wenn dieser Wert auf NULL festgelegt ist, wird die statische Eigenschaft der -Methode zurückgegeben, wie in der Registrierung konfiguriert.

[in] dwSizeOfUserDataIn

Die Größe des in pbUserData bereitgestellten Benutzerdatenpuffers in Byte.

[in] pUserDataIn

Ein Zeiger auf einen Bytepuffer, der das undurchsichtige Benutzerdatenblob enthält. Dieser Parameter kann NULL sein.

[out] pMethodPropertyArray

Ein Zeiger auf das Array der Methodeneigenschaften EAP_METHOD_PROPERTY_ARRAY. Der Aufrufer sollte die inneren Zeiger mithilfe von EapHostPeerFreeMemory freigeben, beginnend am innersten Zeiger. Der Aufrufer sollte nur dann einen empvString-Wert freigeben, wenn der Typ empvtString ist.

[out] ppEapError

Ein Zeiger auf eine 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

Keine

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	eapmethodpeerapis.h
DLL	Eappcfg.dll