XblSocialRelationshipResultGetNextAsync

Article
11/05/2024

Gets the next page of a list of people that the caller is socially connected to.

Syntax

HRESULT XblSocialRelationshipResultGetNextAsync(  
         XblContextHandle xboxLiveContext,  
         XblSocialRelationshipResultHandle resultHandle,  
         size_t maxItems,  
         XAsyncBlock* async  
)

Parameters

xboxLiveContext _In_
Type: XblContextHandle

An xbox live context handle created with XblContextCreateHandle.

resultHandle _In_
Type: XblSocialRelationshipResultHandle

Social relationship result handle from a previous call to XblSocialGetSocialRelationshipsAsync.

maxItems _In_
Type: size_t

Controls the number of XblSocialRelationship objects to get. 0 will return as many as possible.

async _In_
Type: XAsyncBlock*

Caller allocated AsyncBlock.

Return value

Type: HRESULT

HRESULT return code for this API operation.

Remarks

Call this API after finding more results from XblSocialRelationshipResultHasNext. After calling this API, make sure to call XblSocialRelationshipResultGetNextResult to get the result.

Requirements

Header: social_c.h

Library: Microsoft.Xbox.Services.14x.GDK.C.lib

Share via