XUserFindUserByLocalId

特定のローカルユーザー ID に対応するユーザーへのハンドルを取得します。

構文

HRESULT XUserFindUserByLocalId(  
         XUserLocalId userLocalId,  
         XUserHandle* handle  
)  

パラメーター

userLocalId _In_
Type: XUserLocalId ユーザーを取得する対象のローカル ID です。 handle _Out_
Type: XUserHandle* 特定のローカルユーザー ID に関連付けられたユーザーへのハンドルが格納されます。

戻り値

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

Type: 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、Steam Deck、XBOX One ファミリ本体および XBOX Series 本体

概念ドキュメント

時間依存スレッド

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XUserFindUserByLocalId

XUserFindUserByLocalId

構文

パラメーター

戻り値

解説

要件

概念ドキュメント

関連項目

​XUserFindUserByLocalId

​構文

​パラメーター

​戻り値

​解説

​要件

​概念ドキュメント

​関連項目

XUserFindUserByLocalId

構文

パラメーター

戻り値

解説

要件

概念ドキュメント

関連項目