Skip to main content

XblPresenceGetPresenceForSocialGroupAsync

Obtém informações de presença para um grupo específico de usuários.

Sintaxe

Parâmetros

xblContextHandle   _In_
Tipo: XblContextHandle
Contexto do XBOX Live para o usuário local. socialGroupName   _In_z_
Tipo: char*
O nome do grupo de usuários para o qual obter a presença. Pode ser “Favorites” para recuperar informações sobre favoritos, “People” para recuperar informações sobre amigos mútuos e pessoas que um usuário segue, ou “Friends” para recuperar informações sobre amigos mútuos. socialGroupOwnerXuid   _In_opt_
Tipo: uint64_t*
O usuário cujo grupo deve ser usado como destino. Se a entrada for nula, o usuário atual será usado. filters   _In_opt_
Tipo: XblPresenceQueryFilters*
Estrutura de filtros opcional para filtrar os resultados. async   _In_
Tipo: XAsyncBlock*
O AsyncBlock para esta operação.

Valor retornado

Tipo: HRESULT Código de retorno HRESULT para esta operação de API.

Comentários

Para recuperar o resultado da chamada de XblPresenceGetPresenceForSocialGroupAsync, chame XblPresenceGetPresenceForSocialGroupResult. Para recuperar o tamanho de buffer necessário para armazenar os resultados da chamada de XblPresenceGetPresenceForSocialGroupAsync, chame XblPresenceGetPresenceForSocialGroupResultCount.

Requisitos

Cabeçalho: presence_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

presence_c
Last modified on October 6, 2026