EapHostPeerGetResult 函式 (eappapis.h)
取得指定之 EAP 驗證會話的驗證結果。
語法
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
參數
[in] sessionHandle
EAP_SESSIONID 結構的指標，其中包含EAPHost伺服器上這個EAP驗證會話的唯一句柄。 這個句柄會在先前呼叫 EapHostPeerBeginSession 的 pSessionId 參數中傳回。
[in] reason
EapHostPeerMethodResultReason 列舉值，指定ppResult中傳回之驗證結果的原因碼。
[out] ppResult
EapHostPeerMethodResultReason 結構的指標，其中包含驗證結果。 EAPHost 會將 EapHostPeerMethodResult 中定義的驗證相關信息填入此結構。
[out] ppEapError
EAP_ERROR 結構的位址指標。 在呼叫此函式之前，位址應設定為 NULL 。 如果錯誤數據可用，就會收到包含執行此函數調用期間所引發之任何錯誤的 EAP_ERROR 結構地址指標。 Supplicants 必須參考此參數，以判斷驗證是否成功。 使用錯誤數據之後，呼叫 EapHostPeerFreeEapError 以釋放此記憶體。
傳回值
如果函式成功，傳回值 會NO_ERROR。 傳回值不會指出驗證是否成功。 Supplicants 必須參考 ppEapError 參數，以判斷驗證結果。
如果函式失敗，傳回值應該是來自 Winerror.h、Raserror.h 或 Mprerror.h 的適當錯誤碼。
備註
支援者會在驗證完成時呼叫 EapHostPeerGetResult ，這可在下列任何案例中發生。
- 呼叫 EapHostPeerProcessReceivedPacket 會傳回 EapHostPeerResponseResult 動作程序代碼。
- 用戶端逾時，並想要根據目前狀態取得結果。
- 支援者收到替代結果，可能是來自較低層的封包。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eappapis.h |
| 程式庫 | Eappprxy.lib |
| Dll | Eappprxy.dll |