EapPeerInvokeIdentityUI 函式 (eapmethodpeerapis.h)

引發自訂互動式使用者介面對話方塊，以取得用戶端上 EAP 方法的使用者身分識別資訊。

語法

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

參數

[in] pEapType

EAP_METHOD_TYPE結構，其中包含用於驗證連線之 EAP 方法的廠商和作者資訊。

[in] dwFlags

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

[in] hwndParent

父視窗的控制碼，其會繁衍互動式使用者介面對話方塊，以取得身分識別資料。

[in] dwSizeOfConnectionData

pUICoNtextData所指定使用者介面內容資料的大小，以位元組為單位。

[in] pConnectionData

包含連接資料的不透明位元組緩衝區指標。

[out] dwSizeOfUserData

指定 dwSizeOfUserData中傳回之使用者識別資料的大小，以位元組為單位。

[in] pUserData

用於預先填入使用者資料之此驗證特定使用者資料的指標。 第一次呼叫此 API 時，或新的驗證會話啟動時，此參數為 Null。 否則，請將此參數設定為EapPeerGetResult所接收之 ppResult參數所指向之結構的pUserData成員。

[out] pdwSizeOfUserDataOut

指定 ppUserDataOut 緩衝區的大小，以位元組為單位。

[out] ppUserDataOut

傳回之使用者資料的指標指標。 資料會以輸入pUserData的形式傳遞至EapPeerBeginSession。

[out] ppwszIdentity

傳回之使用者身分識別的指標。 指標會包含在身分識別回應封包中，並傳回至伺服器。

[out] ppEapError

EAP_ERROR結構的位址指標，其中包含此函式呼叫執行期間引發的任何錯誤。 取用錯誤資料之後，必須呼叫 EapPeerFreeErrorMemory來釋放此記憶體。

傳回值

無

備註

此呼叫是由對等型 EAPHost 使用此 API 的函式指標來執行。 此 API 必須在 EAPHost 載入的 EAP 方法上實作，而且必須嚴格符合檔中指定的語法和參數類型。

需求

另請參閱

EAPHost 對等方法組態函式

EapPeerInvokeIdentityUI