> ## 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

특정 사용자 그룹에 대한 현재 상태 정보를 가져옵니다.

## Syntax

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

### Parameters

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

로컬 사용자의 XBOX live 컨텍스트입니다.

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

현재 상태를 가져올 사용자 그룹의 이름입니다. 즐겨찾기에 대한 정보를 검색하려면 "Favorites", 상호 친구와 사용자가 팔로우하는 사람에 대한 정보를 검색하려면 "People", 상호 친구에 대한 정보를 검색하려면 "Friends"를 사용할 수 있습니다.

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

대상이 될 그룹의 소유자 사용자입니다. 입력이 null이면 현재 사용자가 사용됩니다.

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

결과를 필터링하기 위한 선택적 filters 구조체입니다.

*async*   \_In\_\
Type: XAsyncBlock\*

이 작업에 대한 AsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업의 HRESULT 반환 코드입니다.

## Remarks

XblPresenceGetPresenceForSocialGroupAsync 호출 결과를 검색하려면 [XblPresenceGetPresenceForSocialGroupResult](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult)를 호출합니다. XblPresenceGetPresenceForSocialGroupAsync 호출 결과를 담을 필요한 버퍼 크기를 검색하려면 [XblPresenceGetPresenceForSocialGroupResultCount](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount)를 호출합니다.

## Requirements

**Header:** presence\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

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