XUser
XUser API 的參考資料。函式
結構
| 結構 | 描述 |
|---|---|
| APP_LOCAL_DEVICE_ID | 指定本機輸入裝置的根 ID。 |
| XUserDeviceAssociationChange | 指定裝置關聯變更時的舊裝置關聯和新裝置關聯。 |
| XUserGetTokenAndSignatureData | 指定為 Web 要求擷取的 xtoken 和簽章。 |
| XUserGetTokenAndSignatureHttpHeader | 指定 Web 要求的 HTTP 標頭。 |
| XUserGetTokenAndSignatureUtf16Data | 包含 Web 要求的 Unicode xtoken 和簽章。 |
| XUserGetTokenAndSignatureUtf16HttpHeader | 包含 Web 要求的 Unicode HTTP 標頭。 |
| XUserLocalId | 指定使用者的遊戲工作階段 ID。 |
| XUserPlatformRemoteConnectEventHandlers | 封裝遠端連線事件處理常式 |
列舉
| 列舉 | 描述 |
|---|---|
| XUserAddOptions | 指定新增使用者的選項。 |
| XUserAgeGroup | 指定使用者的年齡層。 |
| XUserChangeEvent | 指定使用者變更事件的類型。 |
| XUserDefaultAudioEndpointKind | 指定使用者的預設音訊端點是轉譯還是擷取音訊。 |
| XUserGamerPictureSize | 指定玩家圖片的大小 (以像素為單位)。 |
| XUserGamertagComponent | 指定要擷取的玩家代號類型 (或元件)。 |
| XUserGetMsaTokenSilentlyOptions | XUserGetMsaTokenSilentlyOptions 的選項。 |
| XUserGetTokenAndSignatureOptions | GetUserTokenAndSignatureAsync 的選項。 |
| XUserPrivilege | 指定使用者的權限。 |
| XUserPrivilegeDenyReason | 指定使用者無法取得權限的原因。 |
| XUserPrivilegeOptions | 指定使用者權限選項。 |
| XUserState | 指定使用者目前的狀態。 |
| XUserPlatformOperationResult | 定義用戶端作業結果的列舉 |
| XUserPlatformSpopOperationResult | 定義用戶端作業結果的列舉。 |
概念文件
另請參閱
系統 API 參考錯誤碼
XUser API 可能會傳回下列錯誤碼。如需完整清單，請參閱錯誤碼。| 代碼 | 值 | 描述 |
|---|---|---|
| E_GAMEUSER_MAX_USERS_ADDED | 0x89245100 | 無法新增此使用者，因為已達到使用者數目上限。 |
| E_GAMEUSER_SIGNED_OUT | 0x89245101 | 無法執行作業，因為使用者已登出。 |
| E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED | 0x89245102 | 需要 UI 才能解決此使用者的問題。 |
| E_GAMEUSER_DEFERRAL_NOT_AVAILABLE | 0x89245103 | 目前不是要求延遲的適當時機。 |
| E_GAMEUSER_USER_NOT_FOUND | 0x89245104 | 找不到符合該 ID 的使用者。 |
| E_GAMEUSER_NO_TOKEN_REQUIRED | 0x89245105 | 此呼叫不需要權杖。 |
| E_GAMEUSER_NO_DEFAULT_USER | 0x89245106 | 目前沒有預設使用者。如果收到此錯誤，請在不使用 AddDefaultUserSilently 的情況下再次呼叫 XUserAddAsync。 |
| E_GAMEUSER_FAILED_TO_RESOLVE | 0x89245107 | 無法解決指定的權限。 |
| E_GAMEUSER_NO_TITLE_ID | 0x89245108 | 必須設定 XBOX Live TitleId。 |
| E_GAMEUSER_UNKNOWN_GAME_IDENTITY | 0x89245109 | 無法辨識遊戲身分識別。MSAAppId 和 TitleId 與遊戲相關聯的值不符。 |
| E_GAMEUSER_NO_PACKAGE_IDENTITY | 0x89245110 | 必須設定套件身分識別。 |
| E_GAMEUSER_FAILED_TO_GET_TOKEN | 0x89245111 | 權杖要求失敗。 |
| E_GAMEUSER_INVALID_APP_CONFIGURATION | 0x89245112 | 遊戲設定中的 MSAAppId 無效，或未針對驗證堆疊進行設定。 |
| E_GAMEUSER_MALFORMED_MSAAPPID | 0x89245113 | 遊戲設定中的 MSAAppId 不符合預期的格式 (16 個字元的字串或 GUID)。 |
| E_GAMEUSER_INCONSISTENT_MSAAPPID_AND_TITLEID | 0x89245114 | 遊戲設定中的 MSAAppId 和 TitleId 與遊戲相關聯的值不符。 |