共用方式為

EapPeerQueryCredentialInputFields 函式 (eapmethodpeerapis.h)

  • 發行項

定義 EAP 方法特定函式的實作，以取得 EAP 單一登錄 (SSO) EAP 方法的認證輸入欄位。

語法

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [out] EAP_ERROR                    **ppEapError
);

參數

[in] hUserImpersonationToken

要要求和取得其認證之使用者的模擬令牌。

[in] eapMethodType

EAP_METHOD_TYPE 結構，其中包含用於驗證連線之 EAP 方法的廠商和作者資訊。

[in] dwFlags

描述 EAP 驗證會話行為的 EAP 旗標組合。

[in] dwEapConnDataSize

pbEapConnData 所指向之 EAP SSO 組態位元組數據的大小，以位元組為單位。

[in] pbEapConnData

包含EAP組態數據 BLOB 之不透明位元組緩衝區的指標。

[out] pEapConfigFieldsArray

EAP_CONFIG_INPUT_FIELD_ARRAY結構的指標，其中包含要向用戶顯示的輸入欄位。 個別EAP_CONFIG_INPUT_FIELD_DATA元素中的 pwszData 字段會初始化為 NULL。

[out] ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤數據之後，必須將錯誤數據的指標傳遞至 EapPeerFreeErrorMemory，以釋放此記憶體。

傳回值

無

備註

EapPeerQueryCredentialInputFields 支援 SSO。 這個對等方法函式，例如 EapPeerQueryUserBlobFromCredentialInputFields，只會在 SSO 案例中使用。

每當 supplicant 應用程式呼叫 EapHostQueryCredentialInputFields 時，EAPHost 會呼叫此函式的 EAP 方法特定實作。 此函式的實作者負責確保此函式所傳回 的EAP_CONFIG_INPUT_FIELD_ARRAY 包含 EAP 方法向支援者使用者要求之每個認證數據的輸入欄位定義。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 eapmethodpeerapis.h

另請參閱

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO 和 PLAP