XblPresenceGetPresenceForSocialGroupAsync
Gets presence info for a specific group of users.
Syntax
HRESULT XblPresenceGetPresenceForSocialGroupAsync(
XblContextHandle xblContextHandle,
const char* socialGroupName,
uint64_t* socialGroupOwnerXuid,
XblPresenceQueryFilters* filters,
XAsyncBlock* async
)
Parameters
xblContextHandle _In_
Type: XblContextHandle
Xbox live context for the local user.
socialGroupName _In_z_
Type: char*
This can be either "Favorites" to retrieve information about favorites, "Friends" to retrieve information about mutual friends, or "People" to retrieve information about mutual friends and people a user follows (this option is kept for backward compatibility purposes).
socialGroupOwnerXuid _In_opt_
Type: uint64_t*
The user whose group should be targeted. If the input is null, current user will be used.
filters _In_opt_
Type: XblPresenceQueryFilters*
Optional filters struct to filter results.
async _In_
Type: XAsyncBlock*
The AsyncBlock for this operation.
Remarks
To retrieve the result of calling XblPresenceGetPresenceForSocialGroupAsync, call XblPresenceGetPresenceForSocialGroupResult.
To retrieve the required buffer size to hold the results of calling XblPresenceGetPresenceForSocialGroupAsync, call XblPresenceGetPresenceForSocialGroupResultCount.
Return value
Type: HRESULT
HRESULT return code for this API operation.
Requirements
Header: presence_c.h
Library: Microsoft.Xbox.Services.14x.GDK.C.lib