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

# XblSocialGetSocialRelationshipsAsync

> XblSocialGetSocialRelationshipsAsync

# XblSocialGetSocialRelationshipsAsync

Obtém uma lista de pessoas com as quais o chamador tem conexão social.

## Sintaxe

```cpp theme={null}
HRESULT XblSocialGetSocialRelationshipsAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         XblSocialRelationshipFilter socialRelationshipFilter,  
         size_t startIndex,  
         size_t maxItems,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xboxLiveContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Um identificador de contexto do Xbox Live criado com XblContextCreateHandle.

*xboxUserId*   \_In\_\
Tipo: uint64\_t

A ID de usuário do XBOX para a qual obter as relações sociais.

*socialRelationshipFilter*   \_In\_\
Tipo: [XblSocialRelationshipFilter](/pt-BR/reference/live/xsapi-c/social_c/enums/xblsocialrelationshipfilter)

Controla como a lista é filtrada.

*startIndex*   \_In\_\
Tipo: size\_t

Controla o índice inicial da lista de resultados.

*maxItems*   \_In\_\
Tipo: size\_t

O número máximo de itens que a lista de resultados pode conter. Passe 0 para tentar recuperar todos os itens.

*async*   \_In\_\
Tipo: XAsyncBlock\*

[XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) alocado pelo chamador.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Comentários

Chame [XblSocialGetSocialRelationshipsResult](/pt-BR/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsresult) para obter o resultado.

## Chamada REST

V1 GET /users/{ownerId}/people?view={view}\&startIndex={startIndex}\&maxItems={maxItems}

## Requisitos

**Cabeçalho:** social\_c.h

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

## Confira também

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


## Related topics

- [XblSocialGetSocialRelationshipsAsync](/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [XblSocialGetSocialRelationshipsResult](/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsresult.md)
- [Getting a social relationship](/services/xbox-services/community/people-system/how-to/live-getting-a-social-relationship.md)