> ## 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.

# XblMultiplayerWriteSessionByHandleAsync

> XblMultiplayerWriteSessionByHandleAsync

# XblMultiplayerWriteSessionByHandleAsync

Escribe en el servicio una sesión multijugador nueva o actualizada, usando el identificador especificado de la sesión.

## Sintaxis

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionByHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         const char* handleId,  
         XAsyncBlock* async  
)  
```

### Parámetros

*xblContext*   \_In\_\
Tipo: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto de XBOX live del usuario local.

*multiplayerSession*   \_In\_\
Tipo: [XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

Un objeto MultiplayerSession que se ha modificado con los cambios que se van a escribir.

*writeMode*   \_In\_\
Tipo: [XblMultiplayerSessionWriteMode](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode)

El tipo de operación de escritura.

*handleId*   \_In\_\
Tipo: char\*

El identificador del handle que se debe usar al escribir la sesión.

*async*   \_In\_\
Tipo: XAsyncBlock\*

El AsyncBlock para esta operación.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT para esta operación de API.

## Comentarios

Un identificador es un puntero del lado del servicio a una sesión. El identificador de handle es un identificador GUID del handle. Normalmente, los autores de la llamada obtienen el handleId de los XblMultiplayerActivityDetails de otro jugador a través de la API XblMultiplayerGetActivitiesForUsersAsync(), o bien de una invitación. Use este método solo si el objeto de sesión multijugador no tiene un XblMultiplayerSessionReference válido, ya que la duración de un identificador puede ser más corta que la de la sesión a la que apunta.

## Requisitos

**Encabezado:** multiplayer\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Documentación conceptual

* [Recepción de invitaciones](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Consulte también

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


## Related topics

- [XblMultiplayerSessionWriteMode](/es/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionAsync](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [Información general de Multiplayer Session Directory](/es/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Recepción de invitaciones](/es/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)