XblSocialManagerUserGroupGetUsers
사용자 그룹에서 추적하는 사용자의 XblSocialManagerUserPtrArray를 가져옵니다.
구문
HRESULT XblSocialManagerUserGroupGetUsers(
XblSocialManagerUserGroupHandle group,
XblSocialManagerUserPtrArray* users,
size_t* usersCount
)
매개 변수
group _In_
형식: XblSocialManagerUserGroupHandle
사용자를 가져올 그룹 핸들입니다.
users _Outptr_result_maybenull_
형식: XblSocialManagerUserPtrArray*
XblSocialManagerUser 개체의 배열에 관한 포인터를 다시 전달합니다. 반환된 포인터의 메모리는 다음에 XblMultiplayerManagerDoWork를 호출할 때까지 유효한 상태로 유지됩니다.
usersCount _Out_
형식: size_t*
사용자 배열의 크기를 다시 전달합니다.
반환 값
형식: HRESULT
이 API 작업에 대한 HRESULT 반환 코드입니다.
설명
XblSocialManagerUserPtrArray는 다음 XblSocialManagerDoWork 호출 때까지만 유효함이 보장됩니다. 다음 XblSocialManagerDoWork 호출의 범위 이상으로 사용자 개체가 필요한 경우 정적으로 크기가 조정되고 기본적으로 복사가 가능합니다. XblSocialManagerCreateSocialUserGroupFromFilters 또는 XblSocialManagerCreateSocialUserGroupFromList를 호출한 후 이 API를 호출하여 XblSocialManagerUserGroup을 생성합니다. XblSocialManagerDoWork에서 XblSocialManagerEventType::SocialUserGroupLoaded 이벤트에 의해 XblSocialManagerUserGroupHandle이 반환되도록 합니다.
요건
헤더: social_manager_c.h
도서관: Microsoft.Xbox.Services.14x.GDK.C.lib