Skip to main content

XblPrivacyBlockListChangedHandler

A callback invoked when the user’s block list changes.

Syntax

Parameters

eventArgs   _In_
Type: const XblPrivacyBlockListChangeEventArgs*
The arguments associated with the block list change. The fields of the structure are valid only during the callback. context   _In_opt_
Type: void*
The context that was provided when the handler was added.

Return value

Type: void

Remarks

Register this callback by calling XblPrivacyAddBlockListChangedHandler. The context parameter receives the handlerContext value that you passed when you registered the handler. Each call describes one change. The changeType member of eventArgs is XblPrivacyListChangeType::Added or XblPrivacyListChangeType::Removed, and the xuids array lists the XBOX user IDs (XUIDs) that were added to or removed from the block list. The callback reports only what changed, not the full list. The block list is the list that the privacy overview calls the Avoid list. To get the full list, call XblPrivacyGetAvoidListAsync. The xuids array and the other fields of eventArgs are valid only until the callback returns. Copy any XUIDs that you need to keep before you return. You can call XblPrivacyRemoveBlockListChangedHandler from inside the callback.

Argument of

XblPrivacyAddBlockListChangedHandler

Requirements

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

See also

privacy_c
XblPrivacyBlockListChangeEventArgs
XblPrivacyListChangeType
XblPrivacyRemoveBlockListChangedHandler
Privacy overview
Last modified on October 29, 2026