EapPeerSetCredentials 函式 (eapmethodpeerapis.h)

提供新的或更新的驗證認證給 EAP 方法。

語法

DWORD EapPeerSetCredentials(
  [in]  EAP_SESSION_HANDLE sessionHandle,
  [in]  LPWSTR             pwszIdentity,
  [in]  LPWSTR             pwszPassword,
  [out] EAP_ERROR          **ppEapError
);

參數

[in] sessionHandle

EAP_SESSION_HANDLE結構的指標，其中包含 EAPHost 伺服器上這個 EAP 驗證會話的唯一控制碼。 這個控制碼會在先前呼叫EapPeerBeginSession的pSessionHandle參數中傳回。

[in] pwszIdentity

指標，指定要設定認證的使用者身分識別。 呼叫 EapPeerGetIdentity 函式即可取得此使用者識別字串。

[in] pwszPassword

指標，其中包含使用者身分識別的純文字密碼。

[out] ppEapError

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

傳回值

無

備註

如果登錄機碼 InvokeUserNameDlg 已設定，則應該匯出 EapPeerSetCredentials 。 如果未設定登錄機碼 InvokeUserNameDlg ， EapPeerSetCredentials 應該匯出 EapPeerGetIdentity 和 EapPeerInvokeIdentityUI 函式。

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

需求

另請參閱

EAPHost 對等方法 Run-Time 函式

EapPeerGetIdentity

EapPeerInvokeIdentityUI

EapPeerSetCredentials