> ## 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.

# XblSocialAddFriendRequestCountChangedHandler

> 注册一个事件处理程序，用于在注册用户收到的好友请求数量发生更改时接收通知。

# XblSocialAddFriendRequestCountChangedHandler

注册一个事件处理程序，用于接收注册用户收到的好友请求的通知。

## 语法

```cpp theme={null}
HRESULT XblSocialAddFriendRequestCountChangedHandler(  
         XblContextHandle xboxLiveContext,  
         XblSocialIncomingFriendRequestCountChangedHandler handler,  
         void* handlerContext,  
         XblFunctionContext* handlerFunctionContext  
)  
```

### 参数

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

使用 [XblContextCreateHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/xbox_live_context_c/functions/xblcontextcreatehandle.md) 创建的 XBOX 服务上下文句柄。处理程序接收与此上下文关联的用户的通知。

*handler*   \_In\_\
类型：[XblSocialIncomingFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialincomingfriendrequestcountchangedhandler.md)

接收通知的回调函数。

*handlerContext*   \_In\_opt\_\
类型：void\*

要传回处理程序的客户端上下文指针。

*handlerFunctionContext*   \_Out\_\
类型：XblFunctionContext\*

传回用于标识处理程序的令牌。将此令牌传递给 [XblSocialRemoveFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialremovefriendrequestcountchangedhandler.md) 以移除处理程序。

### 返回值

类型：HRESULT

如果处理程序已注册，则返回 `S_OK`。如果 *xboxLiveContext*、*handler* 或 *handlerFunctionContext* 为 null，则返回 `E_INVALIDARG`。

## 备注

当用户待处理的传入好友请求数量发生更改时，处理程序会收到通知。每个通知都会传递一个 [XblSocialFriendRequestCountChangedEventArgs](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/structs/xblsocialfriendrequestcountchangedeventargs.md) 结构，其中包含当前数量。

你无需单独订阅这些通知。注册处理程序时，XBOX Services API (XSAPI) 会为上下文的用户创建对社交关系通知的 Real-Time Activity (RTA) 订阅，或重用现有订阅。好友请求数量处理程序和[社交关系更改处理程序](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialaddsocialrelationshipchangedhandler.md)共享此订阅。只有在你移除该上下文的这两种类型的所有处理程序之后，XSAPI 才会移除该订阅。

如果处理程序引发 C++ 异常，XSAPI 会捕获并记录该异常。

调用 [XblSocialRemoveFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialremovefriendrequestcountchangedhandler.md) 以取消注册事件处理程序。

## 要求

**头文件：** social\_c.h

**库：** Microsoft.Xbox.Services.142.C.lib 或 Microsoft.Xbox.Services.143.C.lib

## 另请参阅

[social\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/social_c_members.md)\
[XblSocialIncomingFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialincomingfriendrequestcountchangedhandler.md)\
[XblSocialRemoveFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialremovefriendrequestcountchangedhandler.md)\
[XblSocialAddSocialRelationshipChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialaddsocialrelationshipchangedhandler.md)


## Related topics

- [XblSocialIncomingFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialincomingfriendrequestcountchangedhandler.md)
- [XblSocialRemoveFriendRequestCountChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialremovefriendrequestcountchangedhandler.md)
- [处理社交关系更改](https://docs.xbox.com/zh-CN/services/xbox-services/community/people-system/how-to/live-handling-a-relationship-change.md)
- [XblSocialRelationshipChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipchangedhandler.md)
- [XblSocialAddSocialRelationshipChangedHandler](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialaddsocialrelationshipchangedhandler.md)