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

# XblMultiplayerActivityInviteData

> XblMultiplayerActivityInviteData

# XblMultiplayerActivityInviteData

描述多人游戏活动邀请。

## 语法

```cpp theme={null}
typedef struct XblMultiplayerActivityInviteData {  
    uint64_t invitedXuid;  
    uint64_t senderXuid;  
    const char* senderImageUrl;  
    char senderGamertag[XBL_GAMERTAG_CHAR_SIZE];  
    char senderModernGamertag[XBL_MODERN_GAMERTAG_CHAR_SIZE];  
    char senderModernGamertagSuffix[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE];  
    char senderUniqueModernGamertag[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE];  
    const char* titleName;  
    const char* titleImageUrl;  
    const char* connectionString;  
    time_t expirationTime;  
} XblMultiplayerActivityInviteData  
```

### 成员

*invitedXuid*\
类型：uint64\_t

被邀请用户的 XBOX 用户 ID。

*senderXuid*\
类型：uint64\_t

发送邀请的用户的 XBOX 用户 ID。

*senderImageUrl*\
类型：const char\*

发送方玩家头像的 URL。

*senderGamertag*\
类型：char\[XBL\_GAMERTAG\_CHAR\_SIZE]

玩家的 UTF-8 编码玩家代号。

*senderModernGamertag*\
类型：char\[XBL\_MODERN\_GAMERTAG\_CHAR\_SIZE]

玩家的 UTF-8 编码新版玩家代号。不保证唯一。

*senderModernGamertagSuffix*\
类型：char\[XBL\_MODERN\_GAMERTAG\_SUFFIX\_CHAR\_SIZE]

附加到新版玩家代号以确保唯一性的 UTF-8 编码后缀。在某些情况下可能为空。

*senderUniqueModernGamertag*\
类型：char\[XBL\_UNIQUE\_MODERN\_GAMERTAG\_CHAR\_SIZE]

UTF-8 编码的唯一新版玩家代号和后缀。格式为“modernGamertag#suffix”。保证呈现的字符数不超过 16 个。

*titleName*\
类型：const char\*

正在发送邀请的标题名称。

*titleImageUrl*\
类型：const char\*

邀请中使用的标题图像的 URL。

*connectionString*\
类型：const char\*

传递给正在连接的客户端以便它可以加入游戏的连接字符串。通常包含诸如服务器 IP 地址之类的信息。

*expirationTime*\
类型：time\_t

过期时间。

## 备注

有关多人游戏活动的详细信息，请参阅[活动](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities)。

## 参数用途

[XblMultiplayerActivityInviteHandler](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityinvitehandler)

## 要求

**头文件：** multiplayer\_activity\_c.h

## 另请参阅

[multiplayer\_activity\_c](/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members)


## Related topics

- [XblMultiplayerActivityInviteHandler](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityinvitehandler.md)
- [XblMultiplayerActivityRemoveInviteHandler](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityremoveinvitehandler.md)
- [XblMultiplayerActivitySendInvitesAsync](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysendinvitesasync.md)
- [XblMultiplayerActivityAddInviteHandler](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityaddinvitehandler.md)
- [XblMultiplayerActivityJoinRestriction](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)