XblMultiplayerManagerJoinGame
使用全域唯一的工作階段名稱加入遊戲工作階段。語法
參數
sessionName _In_z_類型：char* 遊戲工作階段的全域唯一工作階段名稱。 sessionTemplateName _In_z_
類型：char* 遊戲工作階段所依據的工作階段範本名稱。 xuids _In_opt_
類型：uint64_t* XBOX 使用者識別碼 (XUID) 的陣列，代表您要加入遊戲的使用者。 xuidsCount _In_
類型：size_t 為
xuids 指定之陣列中的元素數目。
傳回值
類型：HRESULT 此 API 作業的 HRESULT 傳回碼。備註
此函式會將xuids 中指定的 XBOX 使用者清單，加入由 sessionName. 中指定之全域唯一工作階段名稱所識別的遊戲工作階段。您可以從遊戲第三方配對的結果取得全域唯一的工作階段名稱，而且應該針對所有需要加入遊戲的用戶端呼叫此函式。此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為
XblMultiplayerEventType::JoinGameCompleted。您可以呼叫 XblMultiplayerManagerDoWork 來擷取多人遊戲事件。嘗試加入遊戲工作階段時，如果伺服器已滿，服務會傳回
HTTP_E_STATUS_BAD_REQUEST。加入之後，您可以呼叫 XblMultiplayerManagerGameSessionSetProperties 或 XblMultiplayerManagerGameSessionSetSynchronizedProperties 來設定遊戲工作階段的屬性，或呼叫 XblMultiplayerManagerGameSessionSetSynchronizedHost 來設定遊戲工作階段的主機。