XUserCheckPrivilege
ユーザーが特定の特権を持っているかどうかを判定します。構文
パラメーター
user _In_Type: XUserHandle 特権を確認するユーザーへのハンドルです。 options _In_
Type: XUserPrivilegeOptions ユーザー特権のオプションです。 privilege _In_
Type: XUserPrivilege 確認する特権です。 hasPrivilege _Out_
Type: bool* ユーザーが特定の特権を持っている場合は true、それ以外の場合は false です。 reason _Out_opt_
Type: XUserPrivilegeDenyReason* ユーザーが要求された特権を持っていない理由です。この値は情報提供のみを目的としており、多くのシナリオで不正確な場合があります。この値をタイトル内での判断に使用しないでください。代わりに、XUserResolvePrivilegeWithUiAsync を使用して、すべての特権に関する問題を解決してください。
戻り値
Type: HRESULT HRESULT の成功またはエラー コード。解説
ユーザーが指定された XUserPrivilege を持っているかどうかを判定します。特権が拒否された場合 (すなわち hasPrivilege が false の場合)、ゲームは同じ privilege 値で XUserResolvePrivilegeWithUiAsync を呼び出すことで、プレイヤーに特権を解決する機会を与えることができます。 このメソッドが E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED を返した場合、ゲームは XUserResolveIssueWithUiAsync を呼び出すことで、プレイヤーに問題を解決する機会を与えることができます。注: reason 引数で返される値は情報提供のみを目的としており、多くのシナリオで不正確な場合があります。この値をタイトル内での判断に使用しないでください。