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

# XblSocialRelationshipResultGetRelationships

> XblSocialRelationshipResultGetRelationships

# XblSocialRelationshipResultGetRelationships

Obtém uma lista dos objetos XblSocialRelationship de um XblSocialRelationshipResultHandle.

## Sintaxe

```cpp theme={null}
HRESULT XblSocialRelationshipResultGetRelationships(  
         XblSocialRelationshipResultHandle resultHandle,  
         const XblSocialRelationship** relationships,  
         size_t* relationshipsCount  
)  
```

### Parâmetros

*resultHandle*   \_In\_\
Tipo: [XblSocialRelationshipResultHandle](/pt-BR/reference/live/xsapi-c/social_c/handles/xblsocialrelationshipresulthandle)

Identificador de resultado de relação social.

*relationships*   \_Out\_\
Tipo: [XblSocialRelationship\*\*](/pt-BR/reference/live/xsapi-c/social_c/structs/xblsocialrelationship)

Retorna um ponteiro para uma matriz de objetos XblSocialRelationship. A memória do ponteiro retornado permanece válida durante o tempo de vida do objeto XblSocialRelationshipResultHandle, até que ele seja fechado.

*relationshipsCount*   \_Out\_\
Tipo: size\_t\*

Retorna o número de itens na matriz de relações.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Quando não estiver mais usando o XblSocialRelationshipResultHandle, certifique-se de chamar [XblSocialRelationshipResultCloseHandle](/pt-BR/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultclosehandle). Quando todos os identificadores pendentes forem fechados, a memória associada à lista de resultados da relação social será liberada.

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

- [XblSocialRelationshipResultGetRelationships](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgetrelationships.md)
- [Getting a social relationship](/services/xbox-services/community/people-system/how-to/live-getting-a-social-relationship.md)
- [XblSocialRelationship](/reference/live/xsapi-c/social_c/structs/xblsocialrelationship.md)
