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

# XGameUiShowTextEntryResult

> XGameUiShowTextEntryResult

# XGameUiShowTextEntryResult

Gets the results from a [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync) call.

## Syntax

```cpp theme={null}
HRESULT XGameUiShowTextEntryResult(  
         XAsyncBlock* async,  
         uint32_t resultTextBufferSize,  
         char* resultTextBuffer,  
         uint32_t* resultTextBufferUsed  
)  
```

### Parameters

*async*   \_In\_\
Type: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

A pointer to the [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) that was passed to [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync).

*resultTextBufferSize*   \_In\_\
Type: uint32\_t

The size of the results text buffer, which is used to determine the buffer size that contains the result. You can get this info by calling [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize). Alternatively, if you have a pre-allocated result buffer, you can pass in the size of that result buffer.

*resultTextBuffer*   \_Out\_writes\_to\_(resultTextBufferSize,*resultTextBufferUsed)\
Type: char*

A pointer to the text buffer that contains the result of the player's text input.

*resultTextBufferUsed*   \_Out\_opt\_\
Type: uint32\_t\*

The actual size of the buffer that contained the player's text input.

### Return value

Type: HRESULT

HRESULT success or error code.

## Remarks

Typically this function is to be called in [XGameUiShowTextEntryAsync's](/reference/system/xgameui/functions/xgameuishowtextentryasync) **XAsyncBlock**. This function allows you to retrieve the text input from a text entry field that was originally called for by [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync). To retrieve the size of the text entry result you will need to call [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize).\
You may also call this function anytime after the async function completes in order to retrieve the function result.

## Requirements

**Header:** XGameUI.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, Steam Deck, XBOX One family consoles and XBOX Series consoles

## See also

[XGameUI](/reference/system/xgameui/xgameui_members)\
[XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync)\
[XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize)


## Related topics

- [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize.md)
- [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync.md)
- [XGameUiSetTextEntryUiResponse](/reference/system/xgameui/functions/xgameuisettextentryuiresponse.md)
- [XGameUI](/reference/system/xgameui/xgameui_members.md)
- [XGameUiShowTextEntryUiCallback](/reference/system/xgameui/functions/xgameuishowtextentryuicallback.md)