XUserFindUserByLocalId
特定のローカル ID のユーザーのハンドルを取得します。
構文
HRESULT XUserFindUserByLocalId(
XUserLocalId userLocalId,
XUserHandle* handle
)
パラメーター
userLocalId _In_
型: XUserLocalId
ユーザーを取得するローカル ID。
handle _Out_
型: XUserHandle*
特定のローカル ユーザー ID に関連付けられているユーザーへのハンドルが格納されます。
戻り値
注意
この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。
型: HRESULT
HRESULT 成功またはエラー コード。
| リターン コード | 説明 |
|---|---|
| S_OK | 操作に成功しました。 |
| HRESULT_FROM_WIN32(ERROR_NOT_FOUND) | ユーザーが見つかりませんでした。 |
解説
XUserFindUserByLocalId を含む Xuser API から取得する XUserHandle ハンドルごとに、XUserCloseHandle を呼び出しているハンドルを閉じる必要があります。 Get/Find 関数を呼び出した後に、ハンドルの参照カウントが増加します。
特定のローカル ユーザー ID に対するユーザーのハンドルを取得するには、XUserFindUserByLocalId を呼び出します。
ローカル ユーザーの Xbox ユーザー ID (XUID) を取得するには、XUserFindUserById を呼び出します。
特定のデバイス ID に対するユーザー ID を取得するには、XUserFindForDevice を呼び出します。
要件
ヘッダー: XUser.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体