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

# XGameUiShowStateShareAsync

> XGameUiShowStateShareAsync

# XGameUiShowStateShareAsync

*Observe que este método é uma versão prévia no GDK de junho de 2024.*

Este método mostra uma interface do usuário preenchida com metadados relacionados ao estado que está sendo compartilhado e recursos de UX para compartilhar o estado como um link da Web ou um convite direto.

## Sintaxe

```cpp theme={null}
HRESULT XGameUiShowStateShareAsync(
  XAsyncBlock * async,
  XUserHandle requestingUser,
  const char * linkToken
)
```

### Parâmetros

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

Um ponteiro para o [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) que é passado para [XAsyncRun](/pt-BR/reference/system/xasync/functions/xasyncrun).

*requestingUser*   \_In\_\
Tipo: XUserHandle

Um identificador para o usuário que está enviando os convites.

*linkToken*   \_In\_z\_\
Tipo: const char \*

Um linkToken que faz referência ao estado a ser compartilhado.

## Comentários

Para compartilhar um estado com interface do usuário, depois de criar um estado e um link correspondente, o título deve chamar a API [XGameUiShowStateShareAsync](/pt-BR/reference/system/xgameui/functions/xgameuishowstateshareasync), passando o usuário solicitante e o token de link obtido como parte da criação do link para o estado. Usar o PlayFab é uma maneira de criar estados e links; entre em contato com seu representante da Microsoft para obter detalhes.

## Requisitos

**Cabeçalho:** XGameUI.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de XGameUI](/pt-BR/reference/system/xgameui/xgameui_members)


## Related topics

- [XGameUiShowStateShareAsync](/reference/system/xgameui/functions/xgameuishowstateshareasync.md)
- [XGameUiShowStateShareResult](/reference/system/xgameui/functions/xgameuishowstateshareresult.md)