DismAddPackage 함수
Windows 이미지에 단일 .cab 또는 .msu 파일을 추가합니다.
구문
HRESULT WINAPI DismAddPackage(
_In_ DismSession Session,
_In_ PCWSTR PackagePath,
_In_ BOOL IgnoreCheck,
_In_ BOOL PreventPending,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
매개 변수
Session [in]
유효한 DismSession입니다. DismSession은 이미지와 연결되어야 합니다. DismOpenSession을 사용하여 세션을 이미지와 연결할 수 있습니다.
PackagePath [in]
추가할 .cab 또는 .msu 파일의 상대 또는 절대 경로 또는 단일 .cab 파일의 확장 파일이 들어 있는 폴더입니다.
IgnoreCheck [in]
패키지를 추가할 때 수행된 내부 적용 가능성 검사를 무시할지 여부를 지정하는 부울 값입니다.
| 값 | 설명 |
|---|---|
| TRUE | 내부 적용 가능성 검사를 무시합니다. |
| FALSE | 내부 적용 가능성 검사를 무시하지 않습니다. |
PreventPending [in]
보류 중인 온라인 작업이 있는 경우 패키지를 추가할지 여부를 지정하는 부울 값입니다.
| 값 | 설명 |
|---|---|
| TRUE | 보류 중인 온라인 작업이 있는 패키지의 설치를 방지합니다. |
| FALSE | 보류 중인 온라인 작업이 있는 패키지의 설치를 허용합니다. |
CancelEvent [in, optional]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다. CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트 정의 DismProgressCallback에 대한 포인터입니다.
UserData [in, optional]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
반환 값
성공 시 S_OK을(를) 반환합니다.
설명
.cab 파일만 온라인 이미지에 추가할 수 있습니다. .cab 또는 .msu 파일을 온라인 이미지에 추가할 수 있습니다.
패키지를 적용할 수 없는 경우 이 함수는 특수 오류 코드를 반환합니다. DismGetPackageInfo를 사용하여 패키지가 대상 이미지에 적용 가능한지 확인할 수 있습니다.
예제
HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, 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 |