Skip to main content

XUserCheckPrivilege

判斷使用者是否具有特定權限。

語法

參數

user   _In_
類型:XUserHandle
要檢查其權限之使用者的控制代碼。 options   _In_
類型:XUserPrivilegeOptions
使用者權限選項。 privilege   _In_
類型:XUserPrivilege
要檢查的權限。 hasPrivilege   _Out_
類型:bool*
如果使用者具有特定權限,則為 True,否則為 false。 reason   _Out_opt_
類型:XUserPrivilegeDenyReason*
使用者沒有所要求權限的原因。此值僅供參考, 在許多情況下可能不準確。您的遊戲不應使用此值來做出決策。請改為 使用 XUserResolvePrivilegeWithUiAsync 來解決所有權限問題。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

判斷使用者是否具有指定的 XUserPrivilege。
alert 注意: reason 引數中傳回的值僅供參考,在許多情況下可能不準確。您的遊戲不應使用此值來做出決策。
如果權限遭到拒絕 (亦即 hasPrivilege 為 false),遊戲可以使用相同的 privilege 值呼叫 XUserResolvePrivilegeWithUiAsync,讓玩家有機會解決權限問題。 如果此方法傳回 E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED,遊戲可以呼叫 XUserResolveIssueWithUiAsync,讓玩家有機會解決問題。

需求

標頭: XUser.h 程式庫: xgameruntime.lib 支援的平台: Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XBOX Live 使用者權限的用戶端使用方式 XUser XUserResolvePrivilegeWithUiAsync
Last modified on October 6, 2026