跳转到主要内容

XblSocialAddFriendRequestCountChangedHandler

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

语法

参数

xboxLiveContext   _In_
类型:XblContextHandle
使用 XblContextCreateHandle 创建的 XBOX 服务上下文句柄。处理程序接收与此上下文关联的用户的通知。 handler   _In_
类型:XblSocialIncomingFriendRequestCountChangedHandler
接收通知的回调函数。 handlerContext   _In_opt_
类型:void*
要传回处理程序的客户端上下文指针。 handlerFunctionContext   _Out_
类型:XblFunctionContext*
传回用于标识处理程序的令牌。将此令牌传递给 XblSocialRemoveFriendRequestCountChangedHandler 以移除处理程序。

返回值

类型:HRESULT 如果处理程序已注册,则返回 S_OK。如果 xboxLiveContext、handler 或 handlerFunctionContext 为 null,则返回 E_INVALIDARG。

备注

当用户待处理的传入好友请求数量发生更改时,处理程序会收到通知。每个通知都会传递一个 XblSocialFriendRequestCountChangedEventArgs 结构,其中包含当前数量。 你无需单独订阅这些通知。注册处理程序时,XBOX Services API (XSAPI) 会为上下文的用户创建对社交关系通知的 Real-Time Activity (RTA) 订阅,或重用现有订阅。好友请求数量处理程序和社交关系更改处理程序共享此订阅。只有在你移除该上下文的这两种类型的所有处理程序之后,XSAPI 才会移除该订阅。 如果处理程序引发 C++ 异常,XSAPI 会捕获并记录该异常。 调用 XblSocialRemoveFriendRequestCountChangedHandler 以取消注册事件处理程序。

要求

头文件: social_c.h 库: Microsoft.Xbox.Services.142.C.lib 或 Microsoft.Xbox.Services.143.C.lib

另请参阅

social_c
XblSocialIncomingFriendRequestCountChangedHandler
XblSocialRemoveFriendRequestCountChangedHandler
XblSocialAddSocialRelationshipChangedHandler
最后修改于 2026年10月30日