EapHostPeerGetResult 関数 (eappapis.h)
指定した EAP 認証セッションの認証結果を取得します。
構文
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] sessionHandle
EAPHost サーバー 上のこの EAP 認証セッションの一意のハンドルを含むEAP_SESSIONID構造体へのポインター。 このハンドルは、EapHostPeerBeginSession の以前の呼び出しで pSessionId パラメーターで返されます。
[in] reason
ppResult で返される認証結果の理由コードを指定する EapHostPeerMethodResultReason 列挙値。
[out] ppResult
認証結果を含む EapHostPeerMethodResultReason 構造体へのポインター。 EAPHost は、 EapHostPeerMethodResult で定義されている認証関連情報でこの構造を埋めます。
[out] ppEapError
EAP_ERROR構造体のアドレスへのポインター。 この関数を呼び出す前に、アドレスを NULL に設定する必要があります。 エラー データが使用可能な場合は、この関数呼び出しの実行中に発生したエラーを含む EAP_ERROR 構造体のアドレスへのポインターが受信されます。 サプリカントは、認証が成功したかどうかを判断するために、このパラメーターを参照する必要があります。 エラー データを使用した後、 EapHostPeerFreeEapError を呼び出してこのメモリを解放します。
戻り値
関数が成功した場合、戻り値は NO_ERROR。 戻り値は、認証が成功したかどうかを示すものではありません。 サプリカントは、認証結果を決定するために ppEapError パラメーターを参照する必要があります。
関数が失敗した場合、戻り値は Winerror.h、Raserror.h、または Mprerror.h の適切なエラー コードである必要があります。
注釈
サプリカントは、認証の完了時に EapHostPeerGetResult を呼び出します。これは、次のいずれかのシナリオで発生する可能性があります。
- EapHostPeerProcessReceivedPacket を呼び出すと、EapHostPeerResponseResult アクション コードが返されました。
- クライアントがタイムアウトし、現在の状態に基づいて結果を取得したいと考えています。
- サプリカントは、おそらく下位層のパケットから代替結果を受け取った。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eappapis.h |
| Library | Eappprxy.lib |
| [DLL] | Eappprxy.dll |