> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QueryExecutionState

> IXtfApplicationClient::QueryExecutionState

Queries the execution state of the app with the specified package moniker.

## Syntax

```cpp theme={null}
public:
HRESULT QueryExecutionState(
         LPCWSTR pszPackageMoniker,
         DWORD *dwState
)  
```

### Parameters

*pszPackageMoniker*\
Type: LPCWSTR

A pointer to the package moniker of the app to query.

*dwState*\
Type: DWORD\*

A pointer that receives the execution state of the app. This parameter is set to one of the values listed in the following table.

| Constant | Value | Description |
| - | - | - |
| Unknown | 0 | The execution state of the app is unknown. |
| Running | 1 | The app is currently running. |
| Suspending | 2 | The app is in the process of suspending. |
| Suspended | 3 | Execution of the app is currently suspended. |
| Terminated | 4 | The app has been terminated. |

### Return value

Type: HRESULT

Returns `S_OK` if successful; otherwise, returns an HRESULT error code.

## Remarks

This method queries the execution state of the app with the specified package name. This method is similar to the `xbapp query` command from the Application Management (xbapp.exe) tool,  included as part of the XBOX Tools Framework (XTF). For more information about the `xbapp query` command, see [Application Management (xbapp.exe) (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xbapp.md).

For more information about game life cycle states, see [XBOX Game Life Cycle (NDA topic)](https://docs.xbox.com/build/console-features/console-workflows/xbox-game-life-cycle.md).

## Requirements

**Header:** xtfapplication.h

**Library:** xtfapplication.lib

**Supported platforms:** Windows (for XBOX console tools)

## See also

[IXtfApplicationClient Interface](https://docs.xbox.com/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [IXtfApplicationClient Interface (Interface contents)](https://docs.xbox.com/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [XStoreQueryProductsResult](https://docs.xbox.com/reference/system/xstore/functions/xstorequeryproductsresult.md)
- [XStoreQueryEntitledProductsResult](https://docs.xbox.com/reference/system/xstore/functions/xstorequeryentitledproductsresult.md)
- [XStoreQueryAssociatedProductsResult](https://docs.xbox.com/reference/system/xstore/functions/xstorequeryassociatedproductsresult.md)
- [XStoreQueryProductForPackageResult](https://docs.xbox.com/reference/system/xstore/functions/xstorequeryproductforpackageresult.md)