DismOpenSession 함수
오프라인 또는 온라인 Windows 이미지를 DISMSession과 연결합니다.
구문
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
매개 변수
ImagePath [in]
ImagePath를 다음 값 중 하나로 설정합니다.
- 오프라인 Windows 이미지의 루트 디렉터리에 대한 절대 또는 상대 경로입니다.
- 탑재된 Windows 이미지의 루트 디렉터리에 대한 절대 또는 상대 경로입니다. 외부 도구를 사용하거나 DismMountImage를 사용하여 DismOpenSession을 호출하기 전에 이미지를 탑재할 수 있습니다.
- DISM_ONLINE_IMAGE: 세션을 온라인 Windows 설치와 연결합니다.
WindowsDirectory [in, 선택 사항]
선택 사항입니다. Windows 디렉터리에 대한 상대 또는 절대 경로입니다. 경로는 탑재 지점을 기준으로 합니다.
WindowsDirectory 값이 NULL이면 기본값 "Windows"가 사용됩니다.
ImagePath 매개 변수가 DISM_ONLINE_IMAGE로 설정된 경우 WindowsDirectory 매개 변수를 사용할 수 없습니다.
SystemDrive [in, 선택 사항]
선택 사항입니다. 부팅 관리자가 포함된 시스템 드라이브의 문자입니다.
SystemDrive가 NULL이면 탑재 지점이 포함된 드라이브의 기본값이 사용됩니다.
ImagePath 매개 변수가 DISM_ONLINE_IMAGE로 설정된 경우 SystemDrive 매개 변수를 사용할 수 없습니다.
Session [out]
유효한 DismSession. DismSession은 이미지와 연결되어야 합니다.
DismOpenSession을 사용하여 세션을 이미지와 연결할 수 있습니다.
반환 값
성공하면 S_OK를 반환합니다.
DismSession에 이미 연결된 이미지가 있는 경우 HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)를 반환합니다.
다른 오류에 대해 HRESULT에 매핑된 Win32 오류 코드를 반환합니다.
설명
DismSession은 DismOpenSession 호출이 성공적으로 완료된 후 이미지를 서비스하는 데 사용할 수 있습니다. DismSession은 DismCloseSession을 호출하여 종료해야 합니다.
예제
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
요구 사항
| 요구 사항 | Description |
|---|---|
| 지원되는 호스트 플랫폼 | DISM API는 Windows ADK(Windows Assessment and Deployment Kit)에서 지원하는 모든 운영 체제에서 사용할 수 있습니다. 자세한 내용은 Windows ADK 기술 참조를 참조하세요. |
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |