IXtfApplicationClient::QueryExecutionState
指定されたパッケージ モニカーのアプリの実行状態をクエリします。
構文
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 トピック)認可が必須です」を参照してください。
ゲーム ライフサイクルの状態について詳しくは、「Xbox ゲーム ライフサイクル (NDA トピック)認可が必須です」を参照してください。
要件
ヘッダー: xtfapplication.h
ライブラリ: xtfapplication.lib
サポートされているプラットフォーム: Windows (Xbox 本体ツール用)