跳轉到主要內容

XblSocialManagerGetLocalUsers

傳回 SocialManager 所追蹤之所有使用者的使用者控制代碼。

語法

參數

usersCount   _In_
類型:size_t
使用者控制代碼陣列的大小。 users   _Out_writes_(usersCount)
類型:XblUserHandle*
傳回指向要填入本機使用者之陣列的指標。此陣列只在下次呼叫 XblSocialManagerDoWork 之前有效。傳回的使用者控制代碼並非複製的副本,因此請勿對其呼叫關閉。

傳回值

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

備註

傳回控制代碼之前不會呼叫複製控制代碼,因此如果從 SocialManager 移除使用者之後仍需要該使用者,就必須呼叫複製控制代碼。請務必已呼叫 XblSocialManagerAddLocalUser,為至少一位本機使用者建立社交圖表。此外,請呼叫 XblSocialManagerGetLocalUserCount 以取得目前追蹤的本機使用者數目。

需求

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

另請參閱

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