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

# XblMultiplayerGetSessionByHandleResult

> XblMultiplayerGetSessionByHandleResult

# XblMultiplayerGetSessionByHandleResult

Obtém o resultado de uma chamada de XblMultiplayerGetSessionByHandleAsync.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerGetSessionByHandleResult(  
         XAsyncBlock* async,  
         XblMultiplayerSessionHandle* handle  
)  
```

### Parâmetros

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

O AsyncBlock para esta operação.

*handle*   \_Out\_\
Tipo: [XblMultiplayerSessionHandle\*](/pt-BR/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

Retorna um identificador para uma nova instância de um objeto de sessão multijogador local. Ele deve ser liberado pelo chamador com [XblMultiplayerSessionCloseHandle](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle).

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT desta operação de API.

## Comentários

Se a sessão não existir, esta API retornará \_\_HRESULT\_FROM\_WIN32(ERROR\_RESOURCE\_DATA\_NOT\_FOUND) e um XblMultiplayerSessionHandle nulo.

## Requisitos

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

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

## Confira também

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


## Related topics

- [XblMultiplayerGetSessionResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionresult.md)
- [XblMultiplayerWriteSessionByHandleResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerWriteSessionResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionHandleId](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionhandleid.md)
- [XblMultiplayerGetSessionByHandleAsync](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)