跳轉到主要內容

XblSocialManagerUserGroupGetUsersTrackedByGroup

取得指向由 XSAPI 擁有、包含群組所追蹤之 XUID 的陣列指標。

語法

參數

group   _In_
類型:XblSocialManagerUserGroupHandle
要從中取得使用者的群組。 trackedUsers   _Outptr_result_maybenull_
類型:uint64_t**
傳回指向所追蹤 XUID 陣列的指標。傳回之指標的記憶體會保持有效,直到下次呼叫 XblSocialManagerDoWork 為止。 trackedUsersCount   _Out_
類型:size_t*
傳回所追蹤使用者陣列的大小。

傳回值

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

備註

對於以清單為基礎的群組,所追蹤的使用者集合是靜態的 (亦即建立群組時所提供的 XUID 清單),但對於以篩選條件為基礎的群組,所追蹤的使用者集合會隨著本機使用者的關係變更而改變。請在呼叫 XblSocialManagerCreateSocialUserGroupFromFilters 或 XblSocialManagerCreateSocialUserGroupFromList 建立 XblSocialManagerUserGroup 之後呼叫此 API。須持有 XblSocialManagerDoWork 中 XblSocialManagerEventType::SocialUserGroupLoaded 事件所傳回的 XblSocialManagerUserGroupHandle。

需求

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

另請參閱

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