eapHostPeerGetAuthStatus 函式 (eappapis.h)

  • 發行項

從 EAPHost 取得要求者的目前 EAP 驗證狀態。

語法

DWORD EapHostPeerGetAuthStatus(
  [in]  EAP_SESSIONID         sessionHandle,
  [in]  EapHostPeerAuthParams authParam,
  [out] DWORD                 *pcbAuthData,
  [out] BYTE                  **ppAuthData,
  [out] EAP_ERROR             **ppEapError
);

參數

[in] sessionHandle

EAP_SESSIONID結構的指標，其中包含 EAPHost 伺服器上這個 EAP 驗證會話的唯一控制碼。 這個控制碼會在先前呼叫EapHostPeerBeginSession的pSessionId參數中傳回。

[in] authParam

EapHostPeerAuthParams列舉值，指定要從 EAPHost 取得的 EAP 驗證資料類型。

值 意義
EapHostPeerAuthStatus
 ppAuthData 包含 EAPHOST_AUTH_INFO 結構。
EapHostPeerIdentity
 ppAuthData 包含 WCHAR 緩衝區。
EapHostPeerIdentityExtendedInfo
 ppAuthData 包含 CHAR 緩衝區。
EapHostNapInfo
 Windows 7 或更新版本：[EapHostPeerNapInfo] (/windows/win32/eaphost/eaphostpeernapinfo) 結構。

[out] pcbAuthData

ppAuthData參數所指向之 EAP 驗證資料緩衝區的大小，以位元組為單位。

[out] ppAuthData

位元組緩衝區指標的指標，其中包含來自 EAPHost 的驗證資料。 此資料的格式取決於 authParam中提供的值。

[out] ppEapError

EAP_ERROR結構的位址指標。 在呼叫此函式之前，位址應該設定為 Null 。 如果有錯誤資料可用，就會收到包含此函式呼叫執行期間所引發之 錯誤之EAP_ERROR 結構的位址指標。 使用錯誤資料之後，請呼叫 EapHostPeerFreeEapError釋放此記憶體。

傳回值

無

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 eappapis.h
程式庫 Eappprxy.lib
Dll Eappprxy.dll

另請參閱

EAPHost Supplicant Run-Time 函式