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 方法上實作,而且必須嚴格符合檔中指定的語法和參數類型。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | eapmethodpeerapis.h |