> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerSessionMember

> XblMultiplayerSessionMember

# XblMultiplayerSessionMember

Representa uma referência somente leitura a um membro de uma sessão multijogador.

## Sintaxe

```cpp theme={null}
typedef struct XblMultiplayerSessionMember {  
    uint32_t MemberId;  
    const char* TeamId;  
    const char* InitialTeam;  
    XblTournamentArbitrationStatus ArbitrationStatus;  
    uint64_t Xuid;  
    const char* CustomConstantsJson;  
    const char* SecureDeviceBaseAddress64;  
    const XblMultiplayerSessionMemberRole* Roles;  
    size_t RolesCount;  
    const char* CustomPropertiesJson;  
    char Gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    XblMultiplayerSessionMemberStatus Status;  
    bool IsTurnAvailable;  
    bool IsCurrentUser;  
    bool InitializeRequested;  
    const char* MatchmakingResultServerMeasurementsJson;  
    const char* ServerMeasurementsJson;  
    const uint32_t* MembersInGroupIds;  
    size_t MembersInGroupCount;  
    const char* QosMeasurementsJson;  
    XblDeviceToken DeviceToken;  
    XblNetworkAddressTranslationSetting Nat;  
    uint32_t ActiveTitleId;  
    uint32_t InitializationEpisode;  
    time_t JoinTime;  
    XblMultiplayerMeasurementFailure InitializationFailureCause;  
    const char** Groups;  
    size_t GroupsCount;  
    const char** Encounters;  
    size_t EncountersCount;  
    XblMultiplayerSessionReference TournamentTeamSessionReference;  
    void* Internal;  
} XblMultiplayerSessionMember  
```

### Membros

*MemberId*\
Tipo: uint32\_t

ID deste membro. Exclusiva no contexto da sessão da qual este membro faz parte.

*TeamId*\
Tipo: const char\*

ID da equipe deste membro em um torneio. PRETERIDO. Será removido em uma versão futura

*InitialTeam*\
Tipo: const char\*

Atribuição de equipe inicial do SmartMatch.

*ArbitrationStatus*\
Tipo: [XblTournamentArbitrationStatus](/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus)

Status de arbitragem de um membro em um torneio. PRETERIDO. Será removido em uma versão futura

*Xuid*\
Tipo: uint64\_t

ID de usuário do XBOX do membro. Conhecida somente se o membro tiver aceitado.

*CustomConstantsJson*\
Tipo: const char\*

Cadeia de caracteres JSON que especifica as constantes personalizadas do membro.

*SecureDeviceBaseAddress64*\
Tipo: const char\*

O endereço de dispositivo seguro do membro, codificado em base64. (Opcional)

*Roles*\
Tipo: const [XblMultiplayerSessionMemberRole\*](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole)

Uma matriz de funções para este membro. (Opcional)

*RolesCount*\
Tipo: size\_t

Número de entradas na matriz Roles.

*CustomPropertiesJson*\
Tipo: const char\*

Cadeia de caracteres JSON que especifica as propriedades personalizadas do membro.

*Gamertag*\
Tipo: char\[XBL\_GAMERTAG\_CHAR\_SIZE]

O gamertag do membro. (Opcional) Conhecido somente se o membro tiver aceitado.

*Status*\
Tipo: [XblMultiplayerSessionMemberStatus](/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus)

O status deste membro.

*IsTurnAvailable*\
Tipo: bool

True somente se este membro estiver pronto para o turno.

*IsCurrentUser*\
Tipo: bool

Indica se este MultiplayerSessionMember é do usuário atual.

*InitializeRequested*\
Tipo: bool

Indica que a inicialização de QoS deve ser executada para este usuário. O padrão é false. Ignorado se não houver uma seção "memberInitialization" para a sessão.

*MatchmakingResultServerMeasurementsJson*\
Tipo: const char\*

Quando o match adiciona um usuário a uma sessão, ele pode fornecer algum contexto sobre como e por que o usuário foi combinado na sessão. Esta é uma cópia das serverMeasurements do usuário provenientes da sessão de matchmaking.

*ServerMeasurementsJson*\
Tipo: const char\*

Medições de QoS por cadeia de conexão do servidor de jogo. Como todos os campos, "serverMeasurements" deve ser atualizado como um todo, portanto, deve ser definido uma vez quando a medição for concluída. Se estiver vazio, significa que nenhuma das medições foi concluída dentro do "serverMeasurementTimeout".

*MembersInGroupIds*\
Tipo: const uint32\_t\*

Uma coleção de memberIds no meu grupo. Se uma lista "initializationGroup" estiver definida, o próprio índice do membro sempre será adicionado, caso ainda não esteja presente. Durante a inicialização gerenciada, se algum membro da lista falhar, este membro também falhará.

*MembersInGroupCount*\
Tipo: size\_t

O número de entradas na matriz MembersInGroupIds.

*QosMeasurementsJson*\
Tipo: const char\*

Medições de QoS por endereço de dispositivo seguro. Como todos os campos, "measurements" deve ser atualizado como um todo. Ele deve ser definido uma vez quando a medição for concluída, não de forma incremental. Se um objeto "measurements" estiver definido, ele não poderá conter uma entrada para o próprio endereço do membro.

*DeviceToken*\
Tipo: [XblDeviceToken](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

Definido quando o membro carrega um endereço de dispositivo seguro. É uma cadeia de caracteres que não diferencia maiúsculas de minúsculas e pode ser usada em comparações de igualdade.

*Nat*\
Tipo: [XblNetworkAddressTranslationSetting](/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting)

Esta é a configuração de NAT do dispositivo quando o membro carrega um endereço de dispositivo seguro.

*ActiveTitleId*\
Tipo: uint32\_t

Se o membro estiver ativo, esta é a ID do título no qual ele está ativo.

*InitializationEpisode*\
Tipo: uint32\_t

Esse valor só é útil para leitura quando o título está gerenciando manualmente sua própria QoS. Se a seção "memberInitialization" estiver definida e o membro tiver sido adicionado com "initialize":true, este valor será definido como o episódio de inicialização do qual o membro participará; caso contrário, será 0. Os usuários ingressam nas sessões em lotes. O número do episódio de inicialização indica um conjunto de usuários em relação aos quais a QoS precisa ser executada. O episódio de inicialização 1 é um valor especial usado para os membros adicionados a uma nova sessão no momento da criação.

*JoinTime*\
Tipo: time\_t

A hora em que o usuário ingressou na sessão. Se "reserved" for true, esta é a hora em que a reserva foi feita.

*InitializationFailureCause*\
Tipo: [XblMultiplayerMeasurementFailure](/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure)

A causa da falha da inicialização, ou XblMultiplayerMeasurementFailure::None se não houve falha. Definido ao sair do estágio "joining" ou "measuring" se este membro não for aprovado.

*Groups*\
Tipo: const char\*\*

Uma matriz de nomes de grupos do usuário atual que indica de quais grupos esse usuário fez parte durante uma sessão multijogador.

*GroupsCount*\
Tipo: size\_t

O número de itens na matriz Groups.

*Encounters*\
Tipo: const char\*\*

Obtém uma lista de nomes de grupos do usuário atual que indica quais grupos esse usuário encontrou durante uma sessão multijogador.

*EncountersCount*\
Tipo: size\_t

O número de itens na matriz Groups.

*TournamentTeamSessionReference*\
Tipo: [XblMultiplayerSessionReference](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

A referência da sessão da equipe do torneio. PRETERIDO. Será removido em uma versão futura

*Internal*\
Tipo: void\*

Somente para uso interno.

## Requisitos

**Cabeçalho:** multiplayer\_c.h

## Confira também

[multiplayer\_c](/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionMembers](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [XblMultiplayerSessionMember](/ja-jp/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmember.md)