跳轉到主要內容

XblSocialManagerUserGroupGetUsers

取得使用者群組所追蹤之使用者的 XblSocialManagerUserPtrArray。

語法

參數

group   _In_
類型:XblSocialManagerUserGroupHandle
要從中取得使用者的群組控制代碼。 users   _Outptr_result_maybenull_
類型:XblSocialManagerUserPtrArray*
傳回指向 XblSocialManagerUser 物件陣列的指標。傳回之指標的記憶體會保持有效,直到下次呼叫 XblSocialManagerDoWork 為止。 usersCount   _Out_
類型:size_t*
傳回使用者陣列的大小。

傳回值

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

備註

XblSocialManagerUserPtrArray 只保證在下次呼叫 XblSocialManagerDoWork 之前有效。如果在下次 XblSocialManagerDoWork 呼叫之後仍需要這些使用者物件,由於它們具有靜態大小且可簡單複製,因此可以複製保存。請在呼叫 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日