DISM API 사용
DISM(배포 이미지 서비스 및 관리) API를 사용하면 DISM 플랫폼에서 사용자 지정된 솔루션을 빌드할 수 있습니다. DISM API를 사용하여 Windows 이미지에서 Windows 기능, 패키지 및 드라이버를 설치, 제거, 구성 및 업데이트할 수 있습니다. DISM은 Windows 이미지(.wim) 파일 형식 또는 가상 하드 드라이브(.vhd, .vhdx) 파일에서 Windows 이미지를 관리하고 서비스하는 데 사용할 수 있습니다.
요구 사항
DISM API 애플리케이션을 만들려면 개발 컴퓨터에 Windows ADK(Windows 평가 및 배포 키트)를 설치해야 합니다.
DISM 플랫폼의 사용자 지정된 솔루션은 DISM SDK를 사용하여 개발됩니다. Windows ADK가 설치될 때 설치됩니다. 지원되는 운영 체제에 대한 자세한 내용은 Windows 평가 및 배포 키트(Windows ADK) 기술 참조를 참조하세요.
DISM 플랫폼에서 사용자 지정된 솔루션을 실행하는 경우 Windows ADK 아키텍처 버전이 운영 체제 아키텍처 버전과 일치하는지 확인해야 합니다. 예를 들어 32비트 PC용으로 개발된 사용자 지정 솔루션은 32비트 버전의 Windows 실행됩니다.
DISM 플랫폼에서 사용자 지정된 솔루션을 올바르게 개발하고 실행하려면 Windows ADK에서 DISM 이진 파일을 사용하고 있는지 확인해야 합니다.
사용자 지정된 솔루션을 실행할 PC에 최신 버전의 Windows ADK를 설치합니다.
사용자 지정된 솔루션에 대한 이진 파일은 Windows ADK에서 설치한 DISM 이진 파일과 동일한 디렉터리에 저장해야 합니다. 예를 들어 사용자 지정된 솔루션 이진 파일은 c:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM에 있어야 합니다.
솔루션을 실행하기 전에 필요한 환경 변수가 설정되도록 배포 및 이미징 도구 환경에서 사용자 지정된 솔루션을 실행합니다.
시작 화면에서 배포를 입력합니다. 배포 및 이미징 도구 환경을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을선택합니다.
참고배포 및 이미징 도구 환경에서를 실행하지 않는 경우 PATH 환경 변수가 Windows ADK의 DISM 이진 파일을 사용하는지 확인해야 합니다.
서비스 및 관리에 DISMAPI를 사용하려면 지원되는 Windows 이미지 파일 형식, .wim, .vhd 또는 .vhdx 또는 Windows 온라인 설치가 필요합니다. 일부 작업은 온라인 이미지에서 유효하지 않습니다. 자세한 내용은 DISM API 참조를 참조하세요.
지원되는 대상 이미지
호스트 컴퓨터에서 서비스하는 Windows 이미지 파일은 .wim 파일, .vhd 또는 .vhdx 파일 또는 Windows 온라인 설치일 수 있습니다. 또한 아키텍처 간 서비스가 지원됩니다. x86 시스템 또는 x64 시스템에서 x64 이미지를 서비스할 수 있습니다. x64 시스템 또는 x86 시스템에서 x86 이미지를 서비스할 수 있습니다.
모든 DISMAPI 함수는 Windows 8 및 Windows Server 2012 대상 이미지에서 수행할 수 있습니다. 다른 대상 이미지에서 함수를 수행할 수 있는지 확인하려면 DISM API 참조 에서 함수 참조 항목의 요구 사항 섹션을 참조하세요.
모범 사례
메모리 관리. 특정 DISM API 함수는 구조체 또는 구조체 배열을 반환합니다. 이러한 구조체는 힙의 개체에 대한 포인터로 사용자에게 반환됩니다. 힙 메모리는 DISM API에 의해 할당됩니다. 클라이언트는 DismDelete 함수를 호출하여 이 메모리가 해제되도록 해야 합니다.
DiskPart 도구를 사용하여 VHD 탑재 가능하면 DISM API를 사용하여 DISM 프레임워크 내에서 서비스하려는 이미지를 탑재 및 분리해야 합니다. DiskPart 도구와 같은 다른 도구를 사용하여 이미지를 탑재하고 분리하면 예기치 않은 효과가 있을 수 있습니다.
파일 경로. DISM API 함수에서 허용하는 모든 경로는 상대 경로이거나 절대 경로일 수 있습니다. 파일 경로의 길이를 제한하는 것이 가장 좋습니다. 파일 경로가 너무 길거나 Windows 최대 길이 제한을 초과하면 DISM에서 오류가 발생합니다.
세션을 열고 닫기 위한 호출 일치 DismShutdown함수 를 호출하기 전에 항상 DismCloseSession 함수를 사용하여 DISM 세션을 해제합니다. 세션을 닫은 후 DismShutdown 함수를 호출하기 전에 DismUnmountImage 함수를 통해 이미지를 분리할 수도 있습니다.
기타 DISM 도구
DISM 플랫폼 및 서비스 및 관리 기능에 액세스하는 다른 방법에 대한 자세한 내용은 Windows ADK(Windows 평가 및 배포 키트) 기술 참조에서 DISM 기술 참조를 참조하세요. Windows ADK의 DISM.exe 도구를 사용하여 이미지를 .wim 파일로 캡처할 수도 있습니다.