DismMountImage 함수
WIM 또는 VHD 이미지 파일을 지정된 위치에 탑재합니다.
구문
HRESULT WINAPI DismMountImage(
_In_ PCWSTR ImageFilePath,
_In_ PCWSTR MountPath,
_In_ UINT ImageIndex,
_In_opt_ PCWSTR ImageName,
_In_ DismImageIdentifier ImageIdentifier,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
매개 변수
ImageFilePath [in]
로컬 컴퓨터에 있는 WIM 또는 VHD 파일의 경로입니다. .wim, .vhd 또는 .vhdx 파일 이름 확장명이 필요합니다.
MountPath [in]
이미지를 탑재해야 하는 위치의 경로입니다. 이 탑재 경로는 컴퓨터에 이미 존재해야 합니다. .wim, .vhd 또는 .vhdx 파일의 Windows 이미지는 NTFS로 포맷된 드라이브의 빈 폴더에 탑재할 수 있습니다. .vhd 또는 .vhdx 파일의 Windows 이미지는 할당되지 않은 드라이브 문자에 탑재할 수도 있습니다. 기존 드라이브의 루트에는 이미지를 탑재할 수 없습니다.
ImageIndex [in]
탑재할 WIM 파일의 이미지 인덱스입니다. VHD 파일의 경우 1 인덱스를 지정해야 합니다.
ImageName [in, 선택 사항]
선택 사항입니다. 탑재하려는 이미지의 이름입니다.
Image식별자 [in]
DismImageIndex와 같은 DismImageIdentifier 열거형 값.
Flags [in]
이 작업에 사용할 탑재 플래그입니다. 탑재 플래그에 대한 자세한 내용은 DISM API 상수를 참조하세요.
CancelEvent [in, 선택 사항]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다.
CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트에서 정의한 DismProgressCallback 함수에 대한 포인터입니다.
UserData [in, 선택 사항]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
반환 값
성공하면 S_OK를 반환합니다.
경로 형식이 올바르지 않거나 MountPath 또는 ImageFilePath가 없거나 유효하지 않은 경우 E_INVALIDARG를 반환합니다.
다른 오류에 대해 HRESULT에 매핑된 Win32 오류 코드를 반환합니다.
설명
이미지를 탑재한 후 DismOpenSession을 사용하여 서비스 세션을 시작합니다. 자세한 내용은 DISM API 사용을 참조하세요.
네트워크에 저장된 WIM 또는 VHD 파일에서 이미지를 탑재하는 것은 지원되지 않습니다. 로컬 컴퓨터의 파일을 지정해야 합니다.
VHD 파일에서 이미지를 탑재하려면 1의 ImageIndex를 지정해야 합니다.
MountPath는 컴퓨터에 이미 존재하는 파일 경로여야 합니다. WIM 및 VHD 파일의 이미지는 NTFS로 포맷된 드라이브의 빈 폴더에 탑재할 수 있습니다. VHD 파일의 이미지를 할당되지 않은 드라이브 문자로 탑재할 수도 있습니다. 기존 드라이브의 루트에는 이미지를 탑재할 수 없습니다.
WIM 파일에 이미지를 탑재할 때 이미지는 ImageIndex로 지정된 이미지 인덱스 번호 또는 ImageName으로 지정된 이미지 이름으로 식별할 수 있습니다. ImageIdentifier는 ImageIndex 또는 ImageName 매개 변수를 사용하여 이미지를 식별할지 여부를 지정합니다.
예제
HRESULT hr = S_OK;
hr = DismMountImage(L” C:\\test\\images\\myimage.wim”, L"C:\\test\\offline", 1, NULL, DismImageIndex, DISM_MOUNT_READWRITE, NULL, NULL, NULL);
요구 사항
| 요구 사항 | Description |
|---|---|
| .wim 파일에 지원되는 호스트 플랫폼 | DISM API는 Windows ADK(Windows Assessment and Deployment Kit)에서 지원하는 모든 운영 체제에서 사용할 수 있습니다. 자세한 내용은 Windows ADK 기술 참조를 참조하세요. |
| .vhd 및 .vhdx 파일에 대해 지원되는 호스트 플랫폼 | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 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 |