跳轉到主要內容

XblSocialManagerCreateSocialUserGroupFromList

建構社交 XblSocialManagerUserGroup,這是含有社交資訊的使用者集合。

語法

參數

user   _In_
類型:XblUserHandle
XBOX Live 使用者。 xboxUserIdList   _In_
類型:uint64_t*
要填入 XBOX 社交使用者群組的使用者清單。此清單不可超過 XBL_SOCIAL_MANAGER_MAX_USERS_FROM_LIST。 xboxUserIdListCount   _In_
類型:size_t
xboxUserIdList 中的項目數目。 group   _Outptr_result_maybenull_
類型:XblSocialManagerUserGroupHandle*
傳回所建立群組的控制代碼。此群組稍後可以使用 XblSocialManagerDestroySocialUserGroup 加以清除。如果相關聯的使用者從 Social Manager 中移除,群組也會被清除 (使傳回的控制代碼失效)。

傳回值

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

備註

使用者群組載入的結果會透過 XblSocialManagerDoWork 中的 XblSocialManagerEventType::SocialUserGroupLoaded 事件觸發。

需求

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

另請參閱

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