EAP メソッドに新しい認証資格情報または更新された認証資格情報を提供します。
構文
DWORD EapPeerSetCredentials(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] LPWSTR pwszIdentity,
[in] LPWSTR pwszPassword,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] sessionHandle
EAPHost サーバー上のこの EAP 認証セッションの一意のハンドルを含む EAP_SESSION_HANDLE 構造体へのポインター。 このハンドルは、EapPeerBeginSession の以前の呼び出しで pSessionHandle パラメーターで返されます。
[in] pwszIdentity
資格情報を設定するユーザー ID を指定するポインター。 このユーザー ID 文字列は、 EapPeerGetIdentity 関数を呼び出すことによって取得されます。
[in] pwszPassword
ユーザー ID のクリア テキスト パスワードを含むポインター。
[out] ppEapError
この関数呼び出しの実行中に発生したエラーを含む EAP_ERROR 構造体へのポインター。 エラー データを使用した後、 EapPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。
戻り値
なし
解説
レジストリ キー InvokeUserNameDlg が設定されている場合は、 EapPeerSetCredentials をエクスポートする必要があります。 レジストリ キー InvokeUserNameDlg が設定されていない場合、 EapPeerSetCredentials は EapPeerGetIdentity 関数と EapPeerInvokeIdentityUI 関数をエクスポートする必要があります。
この呼び出しは、この API への関数ポインターを使用して、ピア ベースの EAPHost によって実行されます。 この API は、EAPHost によって読み込まれる EAP メソッドに実装する必要があり、ドキュメントで指定されている構文とパラメーターの型に厳密に準拠している必要があります。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eapmethodpeerapis.h |