EapPeerQueryUserBlobFromCredentialInputFields 函式 (eapmethodpeerapis.h)

EapPeerQueryUserBlobFromCredentialInputFields函式會定義 EAP 方法函式的實作，該函式會取得互動式單一登入 (SSO) UI 所引發的使用者 BLOB 資料。

語法

DWORD EapPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      BYTE                               *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

參數

[in] hUserImpersonationToken

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

[in] eapMethodType

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

[in] dwFlags

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

[in] dwEapConnDataSize

pbEapConnData所指向的 EAP SSO 組態資料大小，以位元組為單位。

[in] pbEapConnData

包含 EAP SSO 組態資料 BLOB 之不透明位元組緩衝區的指標。

[in] pEapConfigInputFieldArray

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

[in, out] pdwUserBlobSize

緩衝區的指標，其中包含 ppUserBlob中不透明使用者設定資料 BLOB 的大小，以位元組為單位。

[in, out] ppbUserBlob

包含不透明使用者資料 BLOB 的指標。

[out] ppEapError

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

傳回值

無

備註

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

EapPeerQueryUserBlobFromCredentialInputFields之後，EAPHost 會呼叫EapPeerBeginSession。 支援者會使用EapHostPeerBeginSession中的EAP_FLAG_PRE_LOGON旗標，指出 EAPHost 應該提供 SSO。

需求

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

另請參閱

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO 和 PLAP