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

> IXtfApplicationClient::Deploy

# IXtfApplicationClient::Deploy

지정된 앱 패키지를 배포합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
public:
HRESULT Deploy(
         LPCWSTR pszDeployFilepath,
         BOOL fRemoveExtraFiles,
         IXtfDeployCallback *pCallback,
         BOOL *pfCanceled,
         int *pdwResult,
         LPBSTR pbstrPackageFullName,
         LPBSTR pbstrAumidJson
)  
```

<a id="parametersSection" />

### 매개 변수

*pszDeployFilepath*<br />형식: LPCWSTR

배포할 콘텐츠의 원본 경로입니다.

*fRemoveExtraFiles*<br />형식: BOOL

이미 개발용 콘솔에 있지만 배포 패키지의 일부가 아닌 파일을 제거하려면 TRUE를 지정하고, 유지하려면 FALSE를 지정합니다.

*pCallback*<br />형식: IXtfDeployCallback\*

배포 중에 추적 가능한 작업이 발생할 때 호출할 [IXtfDeployCallback](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t) 콜백에 대한 포인터입니다. 배포 중에 콜백이 필요하지 않으면 `nullptr`로 설정하세요.

*pfCanceled*<br />형식: BOOL\*

배포가 취소되었는지 여부를 나타내는 부울 값을 받는 포인터입니다.

*pdwResult*<br />형식: int\*

배포 작업의 HRESULT를 받는 포인터입니다. 예를 들어, 열려 있는 파일 핸들 때문에 파일을 삭제할 수 없다면 이 매개 변수는 HRESULT 오류 코드를 받습니다.

*pbstrPackageFullName*<br />형식: LPBSTR

배포된 앱 패키지의 전체 이름을 받는 포인터입니다(버전 번호, 아키텍처, 문화권 포함).

*pbstrAumidJson*<br />형식: LPBSTR

앱 패키지와 연결된 AUMID 목록의 JSON 표현을 받는 포인터입니다. 이 목록의 모든 AUMID는 동일한 `PackageFamilyName`을 공유하지만, 각 AUMID의 느낌표("!") 뒤에는 서로 다른 AppId가 있습니다.

<a id="retvalSection" />

### 반환값

형식: HRESULT

성공하면 `S_OK`를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

이 메서드는 테스트를 위해 XBOX 개발 키트에 타이틀을 푸시 배포합니다. 타이틀은 `pszDeployFilepath`에 지정된 폴더에서 타이틀 스크래치 드라이브로 배포됩니다. 메서드가 배포를 성공적으로 완료하면 타이틀을 시작할 준비가 됩니다. 앱 패키지 배포에 대한 자세한 내용은 [Deploying your title to your XBOX Development Kit (NDA topic)](/home/setup-install/concepts/deployment)를 참조하세요.

<Note>
  이 함수는 동기 방식으로 실행됩니다.
</Note>

이 메서드는 XBOX Tools Framework(XTF)의 일부로 포함된 애플리케이션 관리(xbapp.exe) 도구의 `xbapp deploy` 명령과 유사합니다. `xbapp deploy` 명령에 대한 자세한 내용은 [Application Management (xbapp.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbapp)을 참조하세요.

<a id="remarks_output" />

### LPBSTR 포인터 처리

이 함수가 반환하는 LPBSTR 포인터 처리에 대한 자세한 내용은 [Allocating and Releasing Memory for a BSTR](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019)을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfapplication.h

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

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

<a id="seealsoSection" />

## 참고 항목

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


## Related topics

- [IXtfDeployCallback::OnDeployExtraFileRemoved](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfApplicationClient::DeployEx](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deployex.md)
- [IXtfApplicationClient::DeployToTitleScratch](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deploytotitlescratch.md)
- [IXtfApplicationClient::Uninstall](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/uninstall-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Constrain](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)