EapHostPeerGetIdentity 函式 (eappapis.h)
通道方法會呼叫此函式，以向內部方法要求身分識別資訊。 此函式會傳回身分識別和使用者認證資訊。
語法
DWORD EapHostPeerGetIdentity(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in] HANDLE hTokenImpersonateUser,
[out] BOOL *pfInvokeUI,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError,
[in, out] BYTE **ppvReserved
);
參數
[in] dwVersion
API 的版本號碼。 必須設定為零。
[in] dwFlags
[in] eapMethodType
EAP_METHOD_TYPE結構，指定要用於此會話的 EAP 驗證類型。
[in] dwSizeofConnectionData
pConnectionData參數所指示的緩衝區大小，以位元組為單位。
[in] pConnectionData
用於 EAP 方法之組態資料的指標。
[in] dwSizeofUserData
以位元組為單位的 pUserData 參數所指示的緩衝區大小。
[in] pUserData
與這個驗證會話相關的使用者認證資訊指標。
[in] hTokenImpersonateUser
登入使用者的模擬權杖，以收集使用者相關資訊。
[out] pfInvokeUI
如果使用者身分識別和使用者資料 Blob 未成功傳回，且方法會透過使用者介面對話方塊搜尋從使用者收集資訊，則傳回 TRUE 。
[in, out] pdwSizeOfUserDataOut
ppUserDataOut參數所指示的緩衝區大小，以位元組為單位。
[out] ppUserDataOut
方法傳回的使用者資料資訊。 使用之後，必須呼叫 EapHostPeerFreeRuntimeMemory來釋放此記憶體。
[out] ppwszIdentity
Null 終止使用者識別字串的指標。 使用之後，必須呼叫 EapHostPeerFreeRuntimeMemory來釋放此記憶體。
[out] ppEapError
指向 EAP_ERROR 結構的指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須藉由呼叫 EapHostPeerFreeErrorMemory釋放此記憶體。
[in, out] ppvReserved
保留供日後使用
傳回值
無
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eappapis.h |
| 程式庫 | Eappprxy.lib |
| Dll | Eapphost.dll |