次の方法で共有


XblPresenceGetPresenceForSocialGroupAsync

特定のユーザー グループのプレゼンス情報を取得します。

構文

HRESULT XblPresenceGetPresenceForSocialGroupAsync(  
         XblContextHandle xblContextHandle,  
         const char* socialGroupName,  
         uint64_t* socialGroupOwnerXuid,  
         XblPresenceQueryFilters* filters,  
         XAsyncBlock* async  
)  

パラメーター

xblContextHandle _In_
型: XblContextHandle

ローカル ユーザーの Xbox Live コンテキスト。

socialGroupName _In_z_
型: char*

これには、お気に入りに関する情報を取得するための "Favorites"、共通の友人に関する情報を取得するための "Friends"、またはユーザーがフォローしている共通の友人やユーザーに関する情報を取得するための "People" のいずれかを指定します (このオプションは下位互換性のために維持されています)。

socialGroupOwnerXuid _In_opt_
型: uint64_t*

ターゲットにするグループに属するユーザー。 入力が null の場合、現在のユーザーが使用されます。

フィルター _In_opt_
型: XblPresenceQueryFilters*

結果をフィルター処理するオプションのフィルター構造体。

async _In_
型: XAsyncBlock*

この操作の AsyncBlock。

解説

XblPresenceGetPresenceForSocialGroupAsync を呼び出した結果を取得するには、XblPresenceGetPresenceForSocialGroupResult を呼び出します。

XblPresenceGetPresenceForSocialGroupAsync を呼び出した結果を保持するために必要なバッファー サイズを取得するには、XblPresenceGetPresenceForSocialGroupResultCount を呼び出します。

戻り値

型: HRESULT

この API 操作の HRESULT 結果コード。

要件

ヘッダー: presence_c.h

ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

presence_c