IXtfApplicationClient::DeployEx
지정된 앱 패키지를 배포합니다.
구문
public:
HRESULT DeployEx(
LPCWSTR pszDeployFilepath,
int deployTarget,
BOOL fRemoveExtraFiles,
IXtfDeployCallback *pCallback,
BOOL *pfCanceled,
int *pdwResult,
LPBSTR pbstrPackageFullName,
LPBSTR pbstrAumidJson
)
매개 변수
pszDeployFilepath
형식: LPCWSTR
배포할 콘텐츠의 원본 경로입니다.
deployTarget
형식: int
배포할 드라이브를 나타냅니다. 허용되는 값 및 해당 의미는 다음과 같습니다.
- -1은 'xbconfig defaultstoragedevice'로 지정된 기본 배포 장치를 나타냅니다.
- 0은 소매 드라이브를 사용한다는 것을 의미합니다.
- 1은 개발 드라이브가 있는 콘솔에서 개발 드라이브를 사용한다는 의미입니다.
- 2는 외장형 드라이브 1을 나타내고 3은 외장형 드라이브 2를 나타내며 이후 숫자도 마찬가지입니다.
fRemoveExtraFiles
형식: BOOL
개발 콘솔에 이미 있지만 배포 패키지에 포함되지 않는 파일을 제거하려면 TRUE를 지정하고 이를 유지하려면 FALSE를 지정합니다.
pCallback
형식: IXtfDeployCallback*
배포 중 추적 가능한 작업이 수행될 때 호출할 IXtfDeployCallback 콜백에 대한 포인터입니다. 배포 중 콜백을 원하지 않는 경우 nullptr(으)로 설정합니다.
pfCanceled
형식: BOOL*
배포가 취소되었는지 여부를 나타내는 부울 값을 수신하는 포인터입니다.
pdwResult
형식: int*
배포 작업의 HRESULT를 수신하는 포인터입니다. 예를 들어 열려 있는 파일 핸들로 인해 파일이 삭제되지 않은 경우 이 매개 변수는 HRESULT 오류 코드를 수신합니다.
pbstrPackageFullName
형식: LPBSTR
버전 번호, 아키텍처 및 문화를 포함하여 배포된 앱 패키지의 전체 이름을 수신하는 포인터입니다.
pbstrAumidJson
형식: LPBSTR
앱 패키지와 연결된 AUMID 목록에 대한 JSON 표현을 수신하는 포인터입니다. 목록의 모든 AUMID는 동일한 PackageFamilyName을(를) 공유하지만 각 AUMID에서는 느낌표("!") 다음에 서로 다른 AppId를 가집니다.
반환 값
형식: HRESULT
성공한 경우 S_OK을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드는 테스트를 위해 Xbox 개발 키트에 타이틀에 대한 푸시 배포를 수행합니다. 타이틀은 pszDeployFilepath에 지정된 폴더에서 타이틀 스크래치 드라이브로 배포됩니다. 해당 메서드가 배포를 완료하면 타이틀이 시작할 준비가 된 것입니다. 앱 패키지 배포에 대한 자세한 내용은 Xbox 개발 키트로 타이틀 배포(NDA 항목)권한 부여 필요를 참조하세요.
참고 항목
이 함수는 동시에 실행됩니다.
이 메서드는 XTF(Xbox 도구 프레임워크)의 일부로 포함된 응용 프로그램 관리(xbapp.exe) 도구의 xbapp deploy 명령과 유사합니다.
xbapp deploy 명령에 대한 자세한 내용은 애플리케이션 관리(xbapp.exe)(NDA 항목)권한 부여 필요를 참조하세요.
LPBSTR 포인터 처리
이 API에서 반환하는 LPBSTR 포인터를 처리하는 방법에 대한 자세한 내용은 BSTR용 메모리 할당 및 해제를 참조하세요.
요건
헤더: xtfapplication.h
라이브러리: xtfapplication.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)