eapPeerGetIdentity 函式 (eapmethodpeerapis.h)
由 EAPHost 呼叫之後，傳回使用者資料和使用者身分識別。
語法
DWORD EapPeerGetIdentity(
[in] DWORD dwFlags,
[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] dwFlags
描述 EAP 驗證會話行為的 EAP 旗標 組合。
[in] dwSizeofConnectionData
指定pConnectionData中提供的連線資料緩衝區大小，以位元組為單位
[in] pConnectionData
位元組緩衝區的指標，其中包含不透明的組態資料 BLOB。
[in] dwSizeofUserData
指定 pUserData中提供之使用者資料緩衝區的大小，以位元組為單位。
[in] pUserData
用於預先填入使用者資料之此驗證特定使用者資料的指標。 第一次呼叫此 API 時，或新的驗證會話啟動時，此參數為 Null。 否則，請將此參數設定為EapPeerGetResult所接收之 ppResult參數所指向之結構的pUserData成員。
[in] hTokenImpersonateUser
指定正在驗證之使用者的模擬權杖控制碼。 執行電腦驗證時，此控制碼將會是 Null 。 透過使用此控制碼，EAP 方法可以模擬使用者，以便取得使用者特定資訊，例如使用者名稱、功能變數名稱和認證。
[out] pfInvokeUI
如果未成功傳回使用者身分識別和使用者資料 Blob，則傳回 TRUE ，而且方法會嘗試透過使用者介面對話方塊從使用者收集資訊。
[in, out] pdwSizeOfUserDataOut
指定 ppUserDataOut 緩衝區的大小，以位元組為單位。
[out] ppUserDataOut
指向傳回之使用者資料的指標。 資料會以輸入pUserData的形式傳遞至EapPeerBeginSession。
[out] ppwszIdentity
傳回之使用者身分識別的指標。 指標會包含在身分識別回應封包中，並傳回至伺服器。
[out] ppEapError
指向EAP_ERROR結構的指標，其中包含此函式呼叫執行期間引發的任何錯誤。 取用錯誤資料之後，必須呼叫 EapPeerFreeErrorMemory來釋放此記憶體。
傳回值
無
備註
此呼叫是由對等型 EAPHost 使用此 API 的函式指標來執行。 此 API 必須在 EAPHost 載入的 EAP 方法上實作，而且必須嚴格符合檔中指定的語法和參數類型。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eapmethodpeerapis.h |