> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblPrivacyAddMuteListChangedHandler

> XblPrivacyAddMuteListChangedHandler

Registers an event handler for notifications when the user's mute list changes.

## Syntax

```cpp theme={null}
XblFunctionContext XblPrivacyAddMuteListChangedHandler(  
         XblContextHandle xboxLiveContext,  
         XblPrivacyMuteListChangedHandler handler,  
         void* handlerContext  
)  
```

### Parameters

*xboxLiveContext*   \_In\_\
Type: [XblContextHandle](https://docs.xbox.com/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

An XBOX services context handle created with [XblContextCreateHandle](https://docs.xbox.com/reference/live/xsapi-c/xbox_live_context_c/functions/xblcontextcreatehandle.md).

*handler*   \_In\_\
Type: [XblPrivacyMuteListChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacymutelistchangedhandler.md)

The callback function that receives notifications.

*handlerContext*   \_In\_opt\_\
Type: void\*

Client context pointer to be passed back to the handler.

### Return value

Type: XblFunctionContext

A token that identifies the registered handler. Pass it to [XblPrivacyRemoveMuteListChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacyremovemutelistchangedhandler.md) to unregister the handler. Returns 0 if *xboxLiveContext* or *handler* is null.

## Remarks

The first handler that you register on an XBOX services context subscribes that context to real-time changes in the user's mute list. Later handlers on the same context share that subscription. When you remove the last handler from the context, the context's subscription ends.

The handler receives only the changes to the list, not the current list. To get the full mute list, call [XblPrivacyGetMuteListAsync](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacygetmutelistasync.md).

Call [XblPrivacyRemoveMuteListChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacyremovemutelistchangedhandler.md) to unregister the event handler.

## Requirements

**Header:** privacy\_c.h

**Library:** Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

## See also

[privacy\_c](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/privacy_c_members.md)


## Related topics

- [XblPrivacyMuteListChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacymutelistchangedhandler.md)
- [XblPrivacyRemoveMuteListChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacyremovemutelistchangedhandler.md)
- [privacy_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/privacy_c_members.md)
- [Privacy and permissions overview](https://docs.xbox.com/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [XblPrivacyAddBlockListChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/privacy_c/functions/xblprivacyaddblocklistchangedhandler.md)