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

# IXtfApplicationClient::QueryExecutionState

> IXtfApplicationClient::QueryExecutionState

# IXtfApplicationClient::QueryExecutionState

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

<a id="syntaxSection" />

## 语法

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

<a id="parametersSection" />

### 参数

*pszPackageMoniker*<br />类型：LPCWSTR

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

*dwState*<br />类型：DWORD\*

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

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

<a id="retvalSection" />

### 返回值

类型：HRESULT

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

<a id="remarksSection" />

## 备注

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

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

<a id="requirementsSection" />

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

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

<a id="seealsoSection" />

## 另请参阅

[IXtfApplicationClient Interface](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)<br />[XtfApplication](/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::DebugQuery](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-debugquery.md)
- [IXtfApplicationClient::Constrain](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Launch](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Resume](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/resume-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Snap](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/snap-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)