共用方式為

EapHostPeerQueryUserBlobFromCredentialInputFields 函式 (eaphostpeerconfigapis.h)

  • 發行項

EapHostPeerQueryUserBlobFromCredentialInputFields函式會取得認證 BLOB，可用來從單一登入 (SSO) UI 收到的使用者輸入開始驗證。

語法

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const 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

pConnectionData中提供之連接資料緩衝區的大小，以位元組為單位。

[in] pbEapConnData

用於 EAP 方法的連接資料。

[in] pEapConfigInputFieldArray

EAP_CONFIG_INPUT_FIELD_ARRAY結構的指標，包含 UI 輸入欄位資料。 呼叫端應該使用 函式 EapHostPeerFreeMemory釋放內部指標，從最內部指標開始。

[in, out] pdwUserBlobSize

DWORD 的指標，指定 ppbUserBlob所指向緩衝區的大小，以位元組為單位。 如果此值未設定為零，則必須將此參數中所指定大小的緩衝區指標提供給 ppbUserBlob。

[in, out] ppbUserBlob

可用於驗證之認證 BLOB 的指標。 呼叫 EapHostPeerFreeMemory必須釋放記憶體。 如果為此參數提供非 Null 值， (表示現有的資料 BLOB 會傳遞給它) ，則會更新提供的資料 BLOB，並在此參數中傳回。 如果提供非 Null BLOB 值，則應該使用 LocalAlloc 函式。

[out] ppEapError

指向 EAP_ERROR 結構的指標，其中包含此函式呼叫執行期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須呼叫 EapHostPeerFreeErrorMemory來釋放此記憶體。

傳回值

無

備註

EapHostPeerQueryUserBlobFromCredentialInputFields 支援 SSO。 這個成功函式，例如 EapHostPeerQueryCredentialInputFields，只會在 SSO 案例中使用。

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

需求

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

另請參閱

EAPHost Supplicant 組態函式

SSO 和 PLAP