EapPeerInvokeIdentityUI 関数 (eapmethodpeerapis.h)
カスタム対話型ユーザー インターフェイス ダイアログを生成して、クライアント上の EAP メソッドのユーザー ID 情報を取得します。
構文
DWORD EapPeerInvokeIdentityUI(
[in] EAP_METHOD_TYPE *pEapType,
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] DWORD dwSizeOfConnectionData,
[in] const BYTE *pConnectionData,
[out] DWORD dwSizeOfUserData,
[in] const BYTE *pUserData,
[out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] pEapType
接続の認証に使用される EAP メソッドに関するベンダーおよび作成者情報を含む EAP_METHOD_TYPE 構造。
[in] dwFlags
EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。
[in] hwndParent
ID データを取得するための対話型ユーザー インターフェイス ダイアログを生成する親ウィンドウへのハンドル。
[in] dwSizeOfConnectionData
pUIContextData で指定されたユーザー インターフェイス コンテキスト データのサイズ (バイト単位)。
[in] pConnectionData
接続データを含む不透明なバイト バッファーへのポインター。
[out] dwSizeOfUserData
dwSizeOfUserData で返されるユーザー ID データのサイズをバイト単位で指定します。
[in] pUserData
ユーザー データの事前設定に使用される、この認証に固有のユーザー データへのポインター。 この API が初めて呼び出されたとき、または新しい認証セッションが開始されると、このパラメーターは NULL になります。 それ以外の場合は、EapPeerGetResult によって受信した ppResult パラメーターが指す構造体の pUserData メンバーにこのパラメーターを設定します。
[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 |