Skip to main content
Check multiple permissions with multiple target users. Each permission will be checked against each target user.

Syntax

Parameters

xblContextHandle   _In_
Type: XblContextHandle
XBOX services context for the local user. permissionsToCheck   _In_reads_(permissionsCount)
Type: XblPermission*
Array of permissions to check. permissionsCount   _In_
Type: size_t
Number of entries in the permissions array. targetXuids   _In_reads_(xuidsCount)
Type: uint64_t*
Array of target Xuids to check permissions against. xuidsCount   _In_
Type: size_t
Number of entries in the xuids array. targetAnonymousUserTypes   _In_reads_(targetAnonymousUserTypesCount)
Type: XblAnonymousUserType*
Array of anonymous user types to check permissions against. targetAnonymousUserTypesCount   _In_
Type: size_t
Number of entries in the user types array. async   _In_
Type: XAsyncBlock*
The AsyncBlock for this operation.

Return value

Type: HRESULT Returns S_OK if the request started. S_OK doesn’t mean that permission was granted or that the operation is complete. The function validates its arguments before it starts the request. Possible error codes include the following. This list isn’t exhaustive.

Remarks

Call XblPrivacyBatchCheckPermissionResultSize and XblPrivacyBatchCheckPermissionResult upon completion to get result. The function copies permissionsToCheck, targetXuids, and targetAnonymousUserTypes before it returns, so you can release those arrays after the call. If the operation fails, XblPrivacyBatchCheckPermissionResultSize and XblPrivacyBatchCheckPermissionResult return the failure HRESULT. Pass that HRESULT to XblGetErrorCondition to classify it. A failed request is different from a successful result in which isAllowed is false, but in both cases block the action that the permission protects. If the condition is XblErrorCondition::Http429TooManyRequests, the service is throttling your title. Wait before you try again, and limit how often you retry.

Requirements

Header: privacy_c.h Library: Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

See also

privacy_c
Last modified on October 29, 2026