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

描述 EAP 驗證會話行為的 EAP 旗標組合。

[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

保留供日後使用

傳回值

無

需求

另請參閱

EAPHost Supplicant Run-Time 函式

EapHostPeerGetUICoNtext