XblSocialManagerUserGroupGetUsers
ユーザー グループによって追跡されるユーザーの XblSocialManagerUserPtrArray を取得します。
構文
HRESULT XblSocialManagerUserGroupGetUsers(
XblSocialManagerUserGroupHandle group,
XblSocialManagerUserPtrArray* users,
size_t* usersCount
)
パラメーター
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