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

# XblSocialGetSocialRelationshipsResult

> XblSocialGetSocialRelationshipsResult

# XblSocialGetSocialRelationshipsResult

從 XblSocialGetSocialRelationshipsAsync API 呼叫取得結果控制代碼。

## 語法

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

### 參數

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

傳遞給 [XblSocialGetSocialRelationshipsAsync](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md) 的同一個 AsyncBlock。

*handle*   \_Out\_\
類型：[XblSocialRelationshipResultHandle\*](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/handles/xblsocialrelationshipresulthandle.md)

傳回 XblSocialRelationshipResultHandle。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

不再使用 XblSocialRelationshipResultHandle 時，請務必呼叫 [XblSocialRelationshipResultCloseHandle](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultclosehandle.md)。當所有未關閉的控制代碼都已關閉時，與社交關係結果清單相關聯的記憶體將會被釋放。呼叫此 API 之後，請務必呼叫 [XblSocialRelationshipResultGetRelationships](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgetrelationships.md) 以取得要逐一查看的結果清單。接著呼叫 [XblSocialRelationshipResultHasNext](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresulthasnext.md) 以檢查是否還有其他頁面的結果。

## 需求

**標頭：** social\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[social\_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/social_c_members.md)


## Related topics

- [XblSocialGetSocialRelationshipsAsync](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [XblSocialRelationshipResultGetTotalCount](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresultgettotalcount.md)
- [XblSocialRelationshipResultHasNext](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/functions/xblsocialrelationshipresulthasnext.md)
- [social_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/social_c/social_c_members.md)
- [取得社交關係](https://docs.xbox.com/zh-TW/services/xbox-services/community/people-system/how-to/live-getting-a-social-relationship.md)