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

게임 수명 주기 상태에 대한 자세한 내용은 [XBOX Game Life Cycle (NDA topic)](https://docs.xbox.com/ko/build/console-features/console-workflows/xbox-game-life-cycle.md)을 참조하세요.

## 요구 사항

**헤더:** xtfapplication.h

**라이브러리:** xtfapplication.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

## 참고 항목

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


## Related topics

- [IXtfApplicationClient 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [Query](https://docs.xbox.com/ko/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_query.md)
- [ScriptExecutionError](https://docs.xbox.com/ko/services/playfab/api-references/events/data-types/scriptexecutionerror.md)
- [ActionExecutionError](https://docs.xbox.com/ko/services/playfab/api-references/events/data-types/actionexecutionerror.md)
- [/handles/query](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-handlesquery.md)