次の方法で共有


XUserFindUserById

ローカル ユーザーの Xbox ユーザー ID (XUID) に基づいて XUserHandle を取得します。

構文

HRESULT XUserFindUserById(  
         uint64_t userId,  
         XUserHandle* handle  
)  

パラメーター

userId _In_
型: uint64_t

XUID を取得するローカル ユーザー。

handle _Out_
型: XUserHandle*

ローカル ユーザーの XUID が格納されます。

戻り値

型: HRESULT

HRESULT 成功またはエラー コード。
エラー コードの一覧については、「エラー コード」を参照してください。

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。

XUserFindUserById を含む XUser API から取得する XUserHandle ハンドルごとに、XUserCloseHandle を呼び出しているハンドルを閉じる必要があります。

ローカル ユーザーの XBox ユーザー ID (XUID) を取得するには、XUserFindUserById を呼び出します。

特定のローカル ユーザー ID に対するユーザーのハンドルを取得するには、XUserFindUserByLocalId を呼び出します。

特定のデバイス ID に対するユーザー ID を取得するには、XUserFindForDevice を呼び出します。

要件

ヘッダー: XUser.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XUser

XUserFindUserByLocalId

XUserFindForDevice