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

# IXtfApplicationClient::QueryExecutionState

查询具有指定包 moniker 的应用的执行状态。

## 语法

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

### 参数

*pszPackageMoniker*\
类型：LPCWSTR

指向要查询的应用的包 moniker 的指针。

*dwState*\
类型：DWORD\*

接收应用执行状态的指针。此参数将被设置为下表中列出的值之一。

| 常量 | 值 | 描述 |
| - | - | - |
| Unknown | 0 | 应用的执行状态未知。 |
| Running | 1 | 应用当前正在运行。 |
| Suspending | 2 | 应用正处于暂停过程中。 |
| Suspended | 3 | 应用的执行当前已挂起。 |
| Terminated | 4 | 应用已被终止。 |

### 返回值

类型：HRESULT

如果成功则返回 `S_OK`；否则返回 HRESULT 错误代码。

## 备注

此方法查询具有指定包名的应用的执行状态。此方法类似于 XBOX Tools Framework (XTF) 中包含的应用程序管理 (xbapp.exe) 工具的 `xbapp query` 命令。有关 `xbapp query` 命令的详细信息，请参阅[应用程序管理 (xbapp.exe) (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbapp.md)。

有关游戏生命周期状态的详细信息，请参阅 [XBOX 游戏生命周期 (NDA 主题)](https://docs.xbox.com/zh-CN/build/console-features/console-workflows/xbox-game-life-cycle.md)。

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

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


## Related topics

- [IXtfApplicationClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [Query](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_query.md)
- [ScriptExecutionError](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/scriptexecutionerror.md)
- [ActionExecutionError](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/actionexecutionerror.md)
- [/handles/query](https://docs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handlesquery.md)