EapPeerGetIdentity 関数 (eapmethodpeerapis.h)
EAPHost によって呼び出された後、ユーザー データとユーザー ID を返します。
構文
DWORD EapPeerGetIdentity(
[in] DWORD dwFlags,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in] HANDLE hTokenImpersonateUser,
[out] BOOL *pfInvokeUI,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] dwFlags
EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。
[in] dwSizeofConnectionData
pConnectionData で提供される接続データ バッファーのサイズをバイト単位で指定します
[in] pConnectionData
不透明な構成データ BLOB を含むバイト バッファーへのポインター。
[in] dwSizeofUserData
pUserData で提供されるユーザー データ バッファーのサイズをバイト単位で指定します。
[in] pUserData
ユーザー データの事前設定に使用される、この認証に固有のユーザー データへのポインター。 この API が初めて呼び出されたとき、または新しい認証セッションが開始されると、このパラメーターは NULL になります。 それ以外の場合は、EapPeerGetResult によって受信した ppResult パラメーターが指す構造体の pUserData メンバーにこのパラメーターを設定します。
[in] hTokenImpersonateUser
認証されるユーザーの偽装トークンへのハンドルを指定します。 このハンドルは、マシン認証を行うときは NULL になります。 このハンドルを使用すると、EAP メソッドは、ユーザー名、ドメイン名、資格情報などのユーザー固有の情報を取得するためにユーザーを偽装できます。
[out] pfInvokeUI
ユーザー ID とユーザー データ BLOB が正常に返されず、メソッドがユーザー インターフェイス ダイアログを通じてユーザーから情報を収集しようとしている場合は TRUE を返します。
[in, out] pdwSizeOfUserDataOut
ppUserDataOut バッファーのサイズをバイト単位で指定します。
[out] ppUserDataOut
返されたユーザー データへのポインターへのポインター。 データは、入力 pUserData として EapPeerBeginSession に渡されます。
[out] ppwszIdentity
返されたユーザー ID へのポインター。 ポインターは ID 応答パケットに含まれ、サーバーに返されます。
[out] ppEapError
この関数呼び出しの実行中に発生したエラーを含む 、EAP_ERROR 構造体へのポインターへのポインター。 エラー データを使用した後、 EapPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。
戻り値
なし
解説
この呼び出しは、この API への関数ポインターを使用して、ピア ベースの EAPHost によって実行されます。 この API は、EAPHost によって読み込まれる EAP メソッドに実装する必要があり、ドキュメントで指定されている構文とパラメーターの型に厳密に準拠している必要があります。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eapmethodpeerapis.h |