> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblPresenceGetPresenceForSocialGroupAsync

> XblPresenceGetPresenceForSocialGroupAsync

# XblPresenceGetPresenceForSocialGroupAsync

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

## 構文

```cpp theme={null}
HRESULT XblPresenceGetPresenceForSocialGroupAsync(  
         XblContextHandle xblContextHandle,  
         const char* socialGroupName,  
         uint64_t* socialGroupOwnerXuid,  
         XblPresenceQueryFilters* filters,  
         XAsyncBlock* async  
)  
```

### パラメーター

*xblContextHandle*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

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

*socialGroupName*   \_In\_z\_\
型: char\*

プレゼンスを取得するユーザー グループの名前。お気に入りに関する情報を取得する場合は「Favorites」、相互のフレンドとユーザーがフォローしている人物に関する情報を取得する場合は「People」、相互のフレンドに関する情報を取得する場合は「Friends」を指定できます。

*socialGroupOwnerXuid*   \_In\_opt\_\
型: uint64\_t\*

対象とするグループのユーザー。入力が null の場合は、現在のユーザーが使用されます。

*filters*   \_In\_opt\_\
型: [XblPresenceQueryFilters\*](/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters)

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

*async*   \_In\_\
型: XAsyncBlock\*

この操作の AsyncBlock。

### 戻り値

型: HRESULT

この API 操作の HRESULT 戻りコード。

## 解説

XblPresenceGetPresenceForSocialGroupAsync の呼び出し結果を取得するには、[XblPresenceGetPresenceForSocialGroupResult](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult) を呼び出します。XblPresenceGetPresenceForSocialGroupAsync の呼び出し結果を保持するために必要なバッファー サイズを取得するには、[XblPresenceGetPresenceForSocialGroupResultCount](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount) を呼び出します。

## 要件

**ヘッダー:** presence\_c.h

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

## 関連項目

[presence\_c](/reference/live/xsapi-c/presence_c/presence_c_members)