XblSocialGetSocialRelationshipsResult

Get the result handle from an XblSocialGetSocialRelationshipsAsync API call.

Syntax

HRESULT XblSocialGetSocialRelationshipsResult(  
         XAsyncBlock* async,  
         XblSocialRelationshipResultHandle* handle  
)  

Parameters

async   _In_
Type: XAsyncBlock*

The same AsyncBlock that was passed to XblSocialGetSocialRelationshipsAsync.

handle   _Out_
Type: XblSocialRelationshipResultHandle*

Passes back an XblSocialRelationshipResultHandle.

Return value

Type: HRESULT

HRESULT return code for this API operation.

Remarks

When no longer using the XblSocialRelationshipResultHandle, make sure to call XblSocialRelationshipResultCloseHandle. When all outstanding handles have been closed, the memory associated with the social relationship's results list will be freed. After calling this API, make sure to call XblSocialRelationshipResultGetRelationships to get the results list to iterate over. Then call XblSocialRelationshipResultHasNext to check if there are additional pages of results.

Requirements

Header: social_c.h

Library: Microsoft.Xbox.Services.141.GSDK.C.lib

See also

social_c