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 動作程序代碼。
• 用戶端逾時，並想要根據目前狀態取得結果。
• 支援者收到替代結果，可能是來自較低層的封包。

規格需求

另請參閱

EAPHost Supplicant 運行時間函式

EapHostPeerProcessReceivedPacket