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

# XblSocialGetSocialRelationshipsResult

> XblSocialGetSocialRelationshipsResult

# XblSocialGetSocialRelationshipsResult

Get the result handle from an XblSocialGetSocialRelationshipsAsync API call.

## Syntax

```cpp theme={null}
HRESULT XblSocialGetSocialRelationshipsResult(  
         XAsyncBlock* async,  
         XblSocialRelationshipResultHandle* handle  
)  
```

### Parameters

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

The same AsyncBlock that was passed to [XblSocialGetSocialRelationshipsAsync](/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync).

*handle*   \_Out\_\
Type: [XblSocialRelationshipResultHandle\*](/reference/live/xsapi-c/social_c/handles/xblsocialrelationshipresulthandle)

Passes back an XblSocialRelationshipResultHandle.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

When no longer using the XblSocialRelationshipResultHandle, make sure to call [XblSocialRelationshipResultCloseHandle](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultclosehandle). When all outstanding handles have been closed, the memory associated with the social relationship's results list will be freed. After calling this API, make sure to call [XblSocialRelationshipResultGetRelationships](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgetrelationships) to get the results list to iterate over. Then call [XblSocialRelationshipResultHasNext](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresulthasnext) to check if there are additional pages of results.

## Requirements

**Header:** social\_c.h

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

## See also

[social\_c](/reference/live/xsapi-c/social_c/social_c_members)


## Related topics

- [XblSocialGetSocialRelationshipsAsync](/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [Getting a social relationship](/services/xbox-services/community/people-system/how-to/live-getting-a-social-relationship.md)
- [XblSocialRelationshipResultGetTotalCount](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgettotalcount.md)
- [XblSocialRelationshipResultHasNext](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresulthasnext.md)
- [XblSocialRelationshipResultGetRelationships](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgetrelationships.md)
