EapHostPeerInvokeIdentityUI 函式 (eaphostpeerconfigapis.h)
此函式是由通道方法來呼叫，以叫用內部方法的身分識別 UI。 此函式會傳回要用來啟動驗證的身分識別和認證。
語法
DWORD EapHostPeerInvokeIdentityUI(
[in] DWORD dwVersion,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
參數
[in] dwVersion
API 版本號碼。 必須設定為零。
[in] eapMethodType
EAP_METHOD_TYPE結構，指定要用於此工作階段的EAP驗證類型。
[in] dwFlags
描述 EAP 驗證會話行為的 EAP 旗標 組合。
[in] hwndParent
顯示組態對話框之父視窗的句柄。
[in] dwSizeofConnectionData
pConnectionData 參數所指示的緩衝區大小，以位元組為單位。
[in] pConnectionData
用於 EAP 方法之組態數據的指標。
[in] dwSizeofUserData
pUserData 參數所指示的緩衝區大小，以位元組為單位。
[in] pUserData
與這個驗證相關的使用者認證信息指標。
[in, out] pdwSizeOfUserDataOut
緩衝區集的大小，以位元組為單位接收 ppUserDataOut 參數所傳回的用戶數據。
[out] ppUserDataOut
緩衝區指標的指標，其中包含方法所傳回的用戶數據資訊。 使用之後，必須呼叫 EapHostPeerFreeMemory 來釋放此記憶體。
[out] ppwszIdentity
NULL 終止用戶識別字串的指標。 使用之後，必須呼叫 EapHostPeerFreeMemory 來釋放此記憶體。
[out] ppEapError
指向EAP_ERROR結構的指標，其中包含此函數調用執行期間引發的任何錯誤。 取用錯誤數據之後，必須呼叫 EapHostPeerFreeErrorMemory 來釋放此記憶體。
[in, out] ppvReserved
保留供未來使用。
傳回值
無
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eaphostpeerconfigapis.h |
| 程式庫 | Eappcfg.lib |
| Dll | Eappcfg.dll |