XblSocialGetSocialRelationshipsAsync

获取调用方具有社交关系的人员列表。

语法

HRESULT XblSocialGetSocialRelationshipsAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         XblSocialRelationshipFilter socialRelationshipFilter,  
         size_t startIndex,  
         size_t maxItems,  
         XAsyncBlock* async  
)  

参数

xboxLiveContext _In_
类型:XblContextHandle

使用 XblContextCreateHandle 创建的 xbox live 上下文句柄。

xboxUserId _In_
类型:uint64_t

要获取其社交关系的 Xbox 用户 ID。

socialRelationshipFilter _In_
类型:XblSocialRelationshipFilter

控制如何筛选该列表。

startIndex _In_
类型:size_t

控制结果列表的起始索引。

maxItems _In_
类型:size_t

结果列表可以包含的最多项目数。 传递 0 以尝试检索所有项目。

async _In_
类型:XAsyncBlock*

调用方分配的 XAsyncBlock

返回值

类型:HRESULT

此 API 操作的 HRESULT 返回代码。

备注

调用 XblSocialGetSocialRelationshipsResult 以获取结果。

REST 调用

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

要求

头文件:social_c.h

图书馆: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

social_c