跳轉到主要內容

XblMultiplayerSendInvitesAsync

邀請指定的使用者加入工作階段。這會使用標準邀請文字向每位受邀使用者顯示通知。如果使用者接受該通知,就會啟動該遊戲。

語法

參數

xblContext   _In_
類型:XblContextHandle
本機使用者的 XBOX Live 內容。 sessionReference   _In_
類型:XblMultiplayerSessionReference*
XblMultiplayerSessionReference 物件,代表目標使用者將受邀加入的工作階段。 xuids   _In_
類型:uint64_t*
將受邀的 Xbox 使用者識別碼清單。 xuidsCount   _In_
類型:size_t
xuids 陣列的大小。 titleId   _In_
類型:uint32_t
受邀使用者為了加入工作階段而將啟動之遊戲的識別碼。 contextStringId   _In_opt_z_
類型:char*
自訂內容字串識別碼。此字串識別碼是在 XBOX Live 擷取期間定義,用來識別標準邀請文字之外的額外邀請文字。識別碼字串必須加上 ” /// ” 前置詞。如果不想在邀請中加入自訂字串,請傳遞 nullptr。 customActivationContext   _In_opt_z_
類型:char*
啟用內容字串。由遊戲定義的字串,會傳遞給受邀的遊戲用戶端並依需要解譯。(選用) async   _In_
類型:XAsyncBlock*
此作業的 AsyncBlock。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

需求

標頭: multiplayer_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

概念文件

另請參閱

multiplayer_c
最後修改於 2026年10月6日