跳轉到主要內容

IXtfUserClient::SigninUser

登入以電子郵件地址指定的使用者,並視需要將使用者新增至主機。
在此版本中,此方法透過網路將密碼文字傳遞至主機時不會加密。如果此行為在您的網路環境中是個問題,請使用 AddUser 方法將使用者新增至主機,然後使用主機上的登入應用程式來登入使用者並儲存使用者密碼。(登入應用程式會透過網路傳送加密的密碼。) 之後,您就可以使用此方法登入,而不需傳遞密碼。

語法

參數

emailAddress
類型:LPCWSTR
使用者的電子郵件地址。 password
類型:LPCWSTR
用於登入的密碼。如果已在主機上為此使用者儲存密碼,請傳遞 nullptr 以使用儲存的密碼登入。 bStorePassword
類型:BOOL
如果為 TRUE,則會將指定的密碼儲存在主機上以供日後使用。 pUserId
類型:UINT32 *
成功登入時,指向使用者的使用者識別碼。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

如果使用者已登入,呼叫此方法不會有任何作用。 此方法可能會傳回下列錯誤碼。 若要透過指定使用者識別碼來登入使用者,請使用 SigninUserId。 若要登出使用者,請使用 SignoutUser 或 SignoutUserId。

需求

標頭: xtfuser.h 程式庫: xtfuser.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

IXtfUserClient 介面
最後修改於 2026年10月6日