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 |