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

保留供未來使用。

傳回值

無

規格需求

另請參閱

EAPHost Supplicant 組態函式