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

获取来自 XblSocialGetSocialRelationshipsAsync API 调用的结果句柄。

## 语法

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

### 参数

*async*   \_In\_\
类型：XAsyncBlock\*

传递给 [XblSocialGetSocialRelationshipsAsync](/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync) 的同一个 AsyncBlock。

*handle*   \_Out\_\
类型：[XblSocialRelationshipResultHandle\*](/reference/live/xsapi-c/social_c/handles/xblsocialrelationshipresulthandle)

回传一个 XblSocialRelationshipResultHandle。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

当不再使用 XblSocialRelationshipResultHandle 时，请务必调用 [XblSocialRelationshipResultCloseHandle](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultclosehandle)。当所有未关闭的句柄都已关闭时，将释放与社交关系结果列表关联的内存。调用此 API 后，请务必调用 [XblSocialRelationshipResultGetRelationships](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgetrelationships) 以获取要遍历的结果列表。然后调用 [XblSocialRelationshipResultHasNext](/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresulthasnext) 以检查是否存在更多的结果页。

## 要求

**头文件：** social\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

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


## Related topics

- [XblSocialGetSocialRelationshipsAsync](/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [XblSocialRelationshipResultGetTotalCount](/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgettotalcount.md)
- [XblSocialRelationshipResultHasNext](/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresulthasnext.md)
- [获取社交关系](/zh-CN/services/xbox-services/community/people-system/how-to/live-getting-a-social-relationship.md)
- [XblSocialRelationshipResultGetRelationships](/zh-CN/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgetrelationships.md)