XblMultiplayerWriteSessionByHandleAsync

使用指定的工作階段控制代碼，將新的或已更新的多人遊戲工作階段寫入服務。

語法

HRESULT XblMultiplayerWriteSessionByHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         const char* handleId,  
         XAsyncBlock* async  
)  

參數

xblContext   _In_
類型：XblContextHandle 本機使用者的 XBOX Live 內容。 multiplayerSession   _In_
類型：XblMultiplayerSessionHandle 已使用要寫入之變更修改過的 MultiplayerSession 物件。 writeMode   _In_
類型：XblMultiplayerSessionWriteMode 寫入作業的類型。 handleId   _In_
類型：char* 寫入工作階段時應使用的控制代碼識別碼。 async   _In_
類型：XAsyncBlock* 此作業的 AsyncBlock。

傳回值

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

備註

控制代碼是指向工作階段的服務端指標。控制代碼識別碼是控制代碼的 GUID 識別碼。呼叫端通常會透過 XblMultiplayerGetActivitiesForUsersAsync() API 從其他玩家的 XblMultiplayerActivityDetails 取得 handleId，或從邀請中取得。只有在您的多人遊戲工作階段物件沒有有效的 XblMultiplayerSessionReference 時，才使用此方法，因為控制代碼的存留期可能比其指向的工作階段還短。

需求

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

概念文件

接收邀請

另請參閱

multiplayer_c

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XblMultiplayerWriteSessionByHandleAsync

XblMultiplayerWriteSessionByHandleAsync

語法

參數

傳回值

備註

需求

概念文件

另請參閱

​XblMultiplayerWriteSessionByHandleAsync

​語法

​參數

​傳回值

​備註

​需求

​概念文件

​另請參閱

XblMultiplayerWriteSessionByHandleAsync

語法

參數

傳回值

備註

需求

概念文件

另請參閱