> ## 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 una referencia de solo lectura a un miembro de una sesión multijugador.

## Sintaxis

```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  
```

### Miembros

*MemberId*\
Tipo: uint32\_t

Id. de este miembro. Único dentro del contexto de la sesión de la que forma parte este miembro.

*TeamId*\
Tipo: const char\*

Id. del equipo de este miembro en un torneo. EN DESUSO. Se quitará en una versión futura.

*InitialTeam*\
Tipo: const char\*

Asignación de equipo inicial de SmartMatch.

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

Estado de arbitraje de un miembro en un torneo. EN DESUSO. Se quitará en una versión futura.

*Xuid*\
Tipo: uint64\_t

Identificador de usuario de XBOX del miembro. Solo se conoce si el miembro ha aceptado.

*CustomConstantsJson*\
Tipo: const char\*

Cadena JSON que especifica las constantes personalizadas del miembro.

*SecureDeviceBaseAddress64*\
Tipo: const char\*

La dirección de dispositivo segura del miembro codificada en base64. (Opcional)

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

Una matriz de roles de este miembro. (Opcional)

*RolesCount*\
Tipo: size\_t

Número de entradas de la matriz Roles.

*CustomPropertiesJson*\
Tipo: const char\*

Cadena JSON que especifica las propiedades personalizadas del miembro.

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

El gamertag del miembro. (Opcional) Solo se conoce si el miembro ha aceptado.

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

El estado de este miembro.

*IsTurnAvailable*\
Tipo: bool

Solo es true si este miembro está listo para su turno.

*IsCurrentUser*\
Tipo: bool

Indica si este MultiplayerSessionMember corresponde al usuario actual.

*InitializeRequested*\
Tipo: bool

Indica que se debe ejecutar la inicialización de QoS para este usuario. El valor predeterminado es false. Se omite si no hay una sección "memberInitialization" para la sesión.

*MatchmakingResultServerMeasurementsJson*\
Tipo: const char\*

Cuando el emparejamiento agrega un usuario a una sesión, puede proporcionar cierto contexto sobre cómo y por qué se le emparejó en la sesión. Se trata de una copia de los serverMeasurements del usuario de la sesión de emparejamiento.

*ServerMeasurementsJson*\
Tipo: const char\*

Mediciones de QoS por cadena de conexión del servidor de juego. Como todos los campos, "serverMeasurements" debe actualizarse como un todo, por lo que debe establecerse una vez cuando se complete la medición. Si está vacío, significa que ninguna de las mediciones se completó dentro del "serverMeasurementTimeout".

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

Una colección de memberIds de mi grupo. Si se establece una lista "initializationGroup", el índice del propio miembro siempre se agregará si aún no está presente. Durante la inicialización administrada, si algún miembro de la lista falla, este miembro también fallará.

*MembersInGroupCount*\
Tipo: size\_t

El número de entradas de la matriz MembersInGroupIds.

*QosMeasurementsJson*\
Tipo: const char\*

Mediciones de QoS por dirección de dispositivo segura. Como todos los campos, "measurements" debe actualizarse como un todo. Debe establecerse una vez cuando se complete la medición, no de forma incremental. Si se establece un objeto "measurements", no puede contener una entrada para la propia dirección del miembro.

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

Se establece cuando el miembro carga una dirección de dispositivo segura. Es una cadena que no distingue mayúsculas de minúsculas y que se puede usar para comparaciones de igualdad.

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

Es la configuración de NAT del dispositivo cuando el miembro carga una dirección de dispositivo segura.

*ActiveTitleId*\
Tipo: uint32\_t

Si el miembro está activo, este es el identificador del título en el que está activo.

*InitializationEpisode*\
Tipo: uint32\_t

Este valor solo es útil de leer cuando el título administra manualmente su propia QoS. Si la sección "memberInitialization" está establecida y el miembro se agregó con "initialize":true, se establece en el episodio de inicialización en el que participará el miembro; de lo contrario, es 0. Los usuarios se unen a las sesiones por lotes. El número de episodio de inicialización indica un conjunto de usuarios con respecto a los cuales se debe realizar la QoS. El episodio de inicialización 1 es un valor especial que se usa para los miembros agregados a una sesión nueva en el momento de la creación.

*JoinTime*\
Tipo: time\_t

La hora en la que el usuario se unió a la sesión. Si "reserved" es true, esta es la hora en la que se realizó la reserva.

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

La causa por la que falló la inicialización, o XblMultiplayerMeasurementFailure::None si no hubo ningún error. Se establece al salir de la fase "joining" o "measuring" si este miembro no la supera.

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

Una matriz de nombres de grupo del usuario actual que indica de qué grupos formó parte ese usuario durante una sesión multijugador.

*GroupsCount*\
Tipo: size\_t

El número de elementos de la matriz Groups.

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

Obtiene una lista de nombres de grupo del usuario actual que indica con qué grupos se encontró ese usuario durante una sesión multijugador.

*EncountersCount*\
Tipo: size\_t

El número de elementos de la matriz Groups.

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

La referencia de sesión del equipo del torneo. EN DESUSO. Se quitará en una versión futura.

*Internal*\
Tipo: void\*

Solo para uso interno.

## Requisitos

**Encabezado:** multiplayer\_c.h

## Consulte también

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


## Related topics

- [XblMultiplayerSessionMembers](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [XblMultiplayerSessionMemberStatus](/es/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus.md)
- [XblMultiplayerMeasurementFailure](/es/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure.md)
- [XblTournamentArbitrationStatus](/es/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus.md)
- [XblNetworkAddressTranslationSetting](/es/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting.md)
