DismRemovePackage 함수
이미지에서 패키지를 제거합니다.
구문
HRESULT WINAPI DismRemovePackage(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
매개 변수
Session [in]
유효한 DismSession입니다. DismSession은 이미지와 연결되어야 합니다. DismOpenSession을 사용하여 세션을 이미지와 연결할 수 있습니다.
Identifier [in]
PackageIdentifier 매개 변수 값에 따라 .cab 파일의 절대 경로 또는 패키지 이름입니다.
PackageIdentifier [in]
선택 사항입니다. 유효한 DismPackageIdentifier 열거형 값입니다.
| 값 | 설명 |
|---|---|
| PackageName | 패키지 이름을 사용하여 패키지를 지정하려는 경우 이 값을 사용합니다. |
| PackagePath | .cab 파일의 절대 경로를 사용하여 패키지를 지정하려는 경우 이 값을 사용합니다. |
| PackageNone | 이 함수에 유효한 값이 아닙니다. |
CancelEvent [in, 선택 사항]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다. CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트 정의 DismProgressCallback에 대한 포인터입니다.
UserData [in, optional]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
반환 값
성공하면 S_OK를 반환합니다.
설명
DismRemovePackage 함수는 .msu 파일을 지원하지 않습니다.
예제
HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, NULL, NULL, NULL);
요구 사항
| 요구 사항 | Description |
|---|---|
| 지원되는 호스트 플랫폼 | DISM API는 Windows ADK(Windows Assessment and Deployment Kit)에서 지원하는 모든 운영 체제에서 사용할 수 있습니다. 자세한 내용은 Windows ADK 기술 참조를 참조하세요. |
| 지원되는 이미지 플랫폼 | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE(Windows 사전 설치 환경) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |