XPackageUninstallPackage
지정된 패키지를 제거합니다.
구문
bool XPackageUninstallPackage(
const char* packageIdentifier)
noexcept;
매개 변수
packageIdentifier _In_z_
형식: char*
디스크에 설치된 패키지를 고유하게 식별하는 문자열입니다. 패키지 식별자에 대한 자세한 내용은 DLC(다운로드 가능한 콘텐츠 관리 및 라이선스)를참조하세요.
반환 값
형식: bool
Bool은 패키지가 성공적으로 제거되었는지 여부를 알려줍니다.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
XPackageUninstallPackage는 지정된 패키지를 제거합니다. 제공된 패키지 식별자는 XPackageEnumeratePackages 또는 패키지 식별자를 반환하는 다른 API에서 반환됩니다. XPackageUninstallPackage는 패키지가 제거된 경우 true를 반환하고 패키지를 제거할 수 없는 경우 false를 반환합니다.
패키지를 제거하지 못하는 이유는 다음과 같습니다.
- 패키지가 사용 중입니다. 예를 들어, 게임이 현재 탑재된 DLC 패키지입니다.
- 게임이 xCloud 서버에서 실행되고 있습니다. 패키지 설치 및 제거는 서버 환경의 책임입니다.
다음 예제에서는 XPackageUninstallPackage를 사용하여 패키지를 제거하여 디스크의 공간을 확보합니다.
bool UninstallDlcToReclaimDiskSpace(const char_t* packageIdentifier)
{
return XPackageUninstallPackage(packageIdentifier);
}
요구 사항
헤더: XPackage.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔