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

指定したパッケージ モニカーを持つアプリの実行状態を照会します。

## 構文

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

### パラメーター

*pszPackageMoniker*\
型: LPCWSTR

照会するアプリのパッケージ モニカーへのポインターです。

*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/ja-jp/tools/tools-console/commandlinetools/xbapp.md) を参照してください。

ゲームのライフサイクル状態の詳細については、[XBOX ゲーム ライフサイクル (NDA トピック)](https://docs.xbox.com/ja-jp/build/console-features/console-workflows/xbox-game-life-cycle.md) を参照してください。

## 要件

**ヘッダー:** xtfapplication.h

**ライブラリ:** xtfapplication.lib

**サポートされているプラットフォーム:** Windows (XBOX 本体ツール用)

## 関連項目

[IXtfApplicationClient インターフェイス](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [IXtfApplicationClient インターフェイス (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [Query](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_query.md)
- [ScriptExecutionError](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/data-types/scriptexecutionerror.md)
- [ActionExecutionError](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/data-types/actionexecutionerror.md)
- [/handles/query](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handlesquery.md)