Skip to main content

XUserCheckPrivilege

Determina se um usuário tem um privilégio específico.

Sintaxe

Parâmetros

user   _In_
Tipo: XUserHandle
Um identificador para o usuário cujo privilégio estamos verificando. options   _In_
Tipo: XUserPrivilegeOptions
Opções de privilégio do usuário. privilege   _In_
Tipo: XUserPrivilege
O privilégio a ser verificado. hasPrivilege   _Out_
Tipo: bool*
True se o usuário tiver o privilégio específico; caso contrário, false. reason   _Out_opt_
Tipo: XUserPrivilegeDenyReason*
O motivo pelo qual o usuário não tem o privilégio solicitado. Esse valor é apenas informativo e pode ser impreciso em muitos cenários. Esse valor não deve ser usado para tomar decisões no seu título. Em vez disso, use XUserResolvePrivilegeWithUiAsync para resolver todo e qualquer problema de privilégio.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT.

Comentários

Determina se o usuário tem um determinado XUserPrivilege.
alert OBSERVAÇÃO: O valor retornado no argumento reason é apenas informativo e pode ser impreciso em muitos cenários. Esse valor não deve ser usado para tomar decisões no seu título.
Se um privilégio for negado (ou seja, hasPrivilege for false), o jogo poderá dar ao jogador a oportunidade de resolver o privilégio chamando XUserResolvePrivilegeWithUiAsync com o mesmo valor de privilege. Se este método retornar E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED, o jogo poderá dar ao jogador a oportunidade de resolver o problema chamando XUserResolveIssueWithUiAsync.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

Confira também

Uso de privilégios de usuário do XBOX Live no lado do cliente XUser XUserResolvePrivilegeWithUiAsync
Last modified on October 6, 2026