XUserCheckPrivilege
ユーザーが特定の権限を持つかどうかを判別します。
構文
HRESULT XUserCheckPrivilege(
XUserHandle user,
XUserPrivilegeOptions options,
XUserPrivilege privilege,
bool* hasPrivilege,
XUserPrivilegeDenyReason* reason
)
パラメーター
user _In_
型: XUserHandle
権限をチェックするユーザーに対するハンドル。
options _In_
型: XUserPrivilegeOptions
ユーザー権限のオプション。
privilege _In_
型: XUserPrivilege
チェック対象の権限。
hasPrivilege _Out_
型: bool*
メンバーに特定の権限がある場合は true、それ以外の場合は false。
reason _Out_opt_
型: XUserPrivilegeDenyReason*
ユーザーが要求された特権を持っていない理由。 この値は情報提供のみを目的としており、多くのシナリオでは不正確な場合があります。 この値は、タイトルで決定を行うために使用しないでください。 代わりに、XUserResolvePrivilegeWithUiAsync を 使用して、すべての特権の問題を解決します。
戻り値
型: HRESULT
HRESULT 成功またはエラー コード。
| リターン コード | 説明 |
|---|---|
| S_OK | 操作に成功しました。 |
| E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED | ユーザーは、UI を使用して問題を解決する必要があります。 XUserResolveIssueWithUiAsync を呼び出して、ユーザーに UI を表示してください。 |
解説
指定の XUserPrivilege をユーザーが持っているかどうかを判別します。
注:reason 引数で返される値は情報提供 のみであり、多くのシナリオでは不正確な場合があります。 この値は、タイトルで決定を行うために使用しないでください。
権限が拒否された場合 (つまり hasPrivilege が false の場合)、ゲームは同じ特権値で XUserResolvePrivilegeWithUiAsync を呼び出すことで、プレイヤーに特権を解決する機会を与えることができます。
このメソッドが E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIREDを返す場合、ゲー ムは XUserResolveIssueWithUiAsync を呼び出すことによって、プレイヤーに問題を解決する機会を与えることができます。
要件
ヘッダー: XUser.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体