EapPeerSetCredentials-Funktion (eapmethodpeerapis.h)
Stellt neue oder aktualisierte Authentifizierungsanmeldeinformationen für die EAP-Methode bereit.
Syntax
DWORD EapPeerSetCredentials(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] LPWSTR pwszIdentity,
[in] LPWSTR pwszPassword,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] sessionHandle
Ein Zeiger auf eine EAP_SESSION_HANDLE Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionHandle-Parameter in einem vorherigen Aufruf von EapPeerBeginSession zurückgegeben.
[in] pwszIdentity
Ein Zeiger, der die Benutzeridentität angibt, für die die Anmeldeinformationen festgelegt werden sollen. Diese Benutzeridentitätszeichenfolge wird durch Aufrufen der EapPeerGetIdentity-Funktion abgerufen.
[in] pwszPassword
Ein Zeiger, der das Klartextkennwort für die Benutzeridentität enthält.
[out] ppEapError
Ein Zeiger auf einen Zeiger auf eine 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
Bemerkungen
Wenn der Registrierungsschlüssel InvokeUserNameDlg festgelegt ist, sollte EapPeerSetCredentials exportiert werden. Wenn der Registrierungsschlüssel InvokeUserNameDlg nicht festgelegt ist, sollte EapPeerSetCredentials die Funktionen EapPeerGetIdentity und EapPeerInvokeIdentityUI exportieren.
Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die EAP-Methode implementiert werden, die von EAPHost geladen wird, und sie muss streng den in der Dokumentation angegebenen Syntax- und Parametertypen entsprechen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | eapmethodpeerapis.h |