XblMultiplayerManagerJoinGame
使用全局唯一会话名称加入游戏会话。
语法
HRESULT XblMultiplayerManagerJoinGame(
const char* sessionName,
const char* sessionTemplateName,
const uint64_t* xuids,
size_t xuidsCount
)
参数
sessionName _In_z_
类型：char*
游戏会话的全局唯一会话名称。
sessionTemplateName _In_z_
类型：char*
游戏会话所基于的会话模板的名称。
xuids _In_opt_
类型：uint64_t*
Xbox 用户 ID (XUID) 数组，表示你希望加入游戏的成员。
xuidsCount _In_
类型：size_t
为 xuids 指定的数组中的元素数。
返回值
类型：HRESULT
此 API 操作的 HRESULT 返回代码。
备注
此函数将 xuids 中指定的 Xbox 用户列表加入由 sessionName. 中指定的全局唯一会话名称标识的游戏会话。你可以从游戏的第三方匹配结果中获得全局唯一会话名称，并应该为需要加入游戏的所有客户端调用此函数。
此函数的结果以多人游戏事件的形式传递，事件类型设置为 XblMultiplayerEventType::JoinGameCompleted。 可以调用 XblMultiplayerManagerDoWork 来检索多人游戏事件。
如果在尝试加入游戏会话时服务器已满，则服务将返回 HTTP_E_STATUS_BAD_REQUEST。
加入后，可以通过调用 XblMultiplayerManagerGameSessionSetProperties 或 XblMultiplayerManagerGameSessionSetSynchronizedProperties 来设置游戏会话的属性，或者可以通过调用 XblMultiplayerManagerGameSessionSetSynchronizedHost 来设置游戏会话的主机。
要求
头文件：multiplayer_manager_c.h
图书馆： Microsoft.Xbox.Services.14x.GDK.C.lib