跳转到主要内容

XblSocialRelationshipChangedHandler

在社交关系发生更改时调用的回调。

语法

参数

eventArgs   _In_
类型:const XblSocialRelationshipChangeEventArgs*
与关系更改关联的参数。该结构的字段(包括 xboxUserIds 数组)仅在回调期间有效。 context   _In_opt_
类型:void*
添加处理程序时提供的上下文。

返回值

类型:void

备注

通过调用 XblSocialAddSocialRelationshipChangedHandler 注册此回调。context 参数接收你在注册处理程序时传递的 handlerContext 值。 eventArgs 的 socialNotification 成员为 XblSocialNotificationType::Added、XblSocialNotificationType::Changed 或 XblSocialNotificationType::Removed。请复制回调返回后仍需使用的任何 XBOX 用户 ID。 此回调不会接收传入好友请求数量的更改。若要接收这些更改,请通过调用 XblSocialAddFriendRequestCountChangedHandler 注册 XblSocialIncomingFriendRequestCountChangedHandler。 你无需单独订阅社交关系更改。添加处理程序时,XBOX Services API (XSAPI) 会为上下文的用户创建 Real-Time Activity (RTA) 订阅,或重用现有订阅。

参数属于

XblSocialAddSocialRelationshipChangedHandler

要求

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

另请参阅

social_c
XblSocialRelationshipChangeEventArgs
XblSocialRemoveSocialRelationshipChangedHandler
最后修改于 2026年11月3日