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

# XblPresenceGetPresenceForSocialGroupAsync

> XblPresenceGetPresenceForSocialGroupAsync

Gets presence info for a specific group of users.

## Syntax

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

### Parameters

*xblContextHandle*   \_In\_\
Type: [XblContextHandle](https://docs.xbox.com/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

XBOX live context for the local user.

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

The name of the group of users to get presence for. This can be either "Favorites" to retrieve information about favorites, "People" to retrieve information about mutual friends and people a user follows, or "Friends" to retrieve information about mutual friends.

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

The user whose group should be targeted. If the input is null, current user will be used.

*filters*   \_In\_opt\_\
Type: [XblPresenceQueryFilters\*](https://docs.xbox.com/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md)

Optional filters struct to filter results.

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

The AsyncBlock for this operation.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

To retrieve the result of calling XblPresenceGetPresenceForSocialGroupAsync, call [XblPresenceGetPresenceForSocialGroupResult](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult.md). To retrieve the required buffer size to hold the results of calling XblPresenceGetPresenceForSocialGroupAsync, call [XblPresenceGetPresenceForSocialGroupResultCount](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount.md).

## Requirements

**Header:** presence\_c.h

**Library:** Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

## See also

[presence\_c](https://docs.xbox.com/reference/live/xsapi-c/presence_c/presence_c_members.md)


## Related topics

- [XblPresenceGetPresenceForSocialGroupResult](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult.md)
- [XblPresenceGetPresenceForSocialGroupResultCount](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount.md)
- [Getting a user's Presence](https://docs.xbox.com/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceQueryFilters](https://docs.xbox.com/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md)
- [presence_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/presence_c/presence_c_members.md)