Skip to main content

XUserAddOptions

ユーザーを追加するためのオプションを指定します。

構文

定数

解説

options に XUserAddOptions::AddDefaultUserSilently を設定して XUserAddAsync を繰り返し呼び出す場合、開発者が知っておくべきエッジ ケースがいくつかあります:
  • ゲームを起動した既定のユーザーが判明している状態でこれを繰り返し呼び出すと、同じユーザーが返されます。
  • 以前に判明していた既定のユーザーがサインアウトしており、デバイスに 1 人のユーザーだけがサインインしている場合、そのユーザーが新しい「既定」のユーザーとしてマークされ、そのユーザーが返されます。
  • 以前に判明していた既定のユーザーがサインアウトしており、デバイスに複数のユーザーがサインインしている場合、E_GAMEUSER_NO_DEFAULT_USER が返されます。
  • 開発者による起動時は、既定のユーザーとなるのは自動サインイン ユーザーです。これは DevHome でそのユーザーを自動サインイン ユーザーとして設定するか、xbconfig (NDA トピック) の DefaultUser を使用することで指定できます。
既定のユーザーが利用できない場合、XUserAddResult は E_GAMEUSER_NO_DEFAULT_USER を返します。options に XUserAddOptions::AddDefaultUserSilently を設定せずに XUserAddAsync を呼び出す必要があります。 options に XUserAddOptions::AddDefaultUserAllowingUI を設定して XUserAddAsync を繰り返し呼び出す場合にも、開発者が知っておくべきエッジ ケースがいくつかあります。これらは、サイレント UI の場合と非常に似ています (ただし同一ではありません):
  • ゲームを起動した既定のユーザーが判明している状態でこれを繰り返し呼び出すと、同じユーザーが返されます。
  • 以前に判明していた既定のユーザーがサインアウトしており、デバイスに 1 人のユーザーだけがサインインしている場合、そのユーザーが新しい「既定」のユーザーとしてマークされ、そのユーザーが返されます。
  • 最初にゲームを起動したユーザーがサインアウトしており、ユーザーの数が 0 人または 2 人以上の場合、システムはユーザーを取得するために UI を表示し、そのユーザーを既定として設定します。
XUserAddAsync では、XUserAddOptions::AllowGuests を XUserAddOptions::AddDefaultUserSilently と一緒に使用することはできません。ゲストは既定のユーザーになれません。 現在のプラットフォームがゲストをサポートしていない場合でも、XUserAddOptions::AllowGuests を使用できます。 次の例では、ゲーム セッションにユーザーを非同期的に追加する方法を示します。

要件

ヘッダー: XUser.h サポートされているプラットフォーム: Windows、XBOX One 本体、XBOX Series 本体

関連項目

XUser XUserAddAsync XUserAddResult
最終更新日 2026年8月24日