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

지정된 패키지 모니커의 앱 실행 상태를 쿼리합니다.

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*pszPackageMoniker*<br />형식: LPCWSTR

쿼리할 앱의 패키지 모니커에 대한 포인터입니다.

*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` 명령에 대한 자세한 내용은 [Application Management (xbapp.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbapp)을 참조하세요.

게임 수명 주기 상태에 대한 자세한 내용은 [XBOX Game Life Cycle (NDA topic)](/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](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-debugquery.md)
- [IXtfApplicationClient::Constrain](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Resume](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/resume-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Snap](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/snap-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Suspend](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows.md)