DismInitialize 함수
[일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적 또는 묵시적 보증을 하지 않습니다.]
DISM API를 초기화합니다. DismInitialize 는 다른 DISM API 함수를 호출하기 전에 프로세스당 한 번 호출되어야 합니다.
구문
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
매개 변수
LogLevel [in]
DismLogErrorsWarnings와 같은 DismLogLevel 열거형 값입니다.
LogFilePath [in, 선택 사항]
선택 사항입니다. 로그 파일의 상대 경로 또는 절대 경로입니다. 생성된 모든 메시지가 이 경로에 기록됩니다. NULL이면 기본 로그 경로인 %windir%\Logs\DISM\dism.log가 사용됩니다.
ScratchDirectory [in, 선택 사항]
선택 사항입니다. 스크래치 디렉터리의 상대 경로 또는 절대 경로입니다. DISM API는 내부 작업에 이 디렉터리를 사용합니다. NULL인 경우에는 기본 임시 디렉터리인 \Windows\%Temp%가 사용됩니다.
반환 값
성공하면 S_OK를 반환합니다.
DismShutdown에 대한 일치하는 호출 없이 프로세스에서 DismInitialize를 이미 호출한 경우 DISMAPI_E_DISMAPI_ALREADY_INITIALIZED를 반환합니다.
프로세스가 관리자 권한으로 실행되지 않은 경우 HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED)를 반환합니다.
설명
클라이언트 코드는 프로세스당 한 번씩 DismInitialize를 호출해야 합니다. DISM API는 DismInitialize에 대한 동시 호출을 직렬화합니다. 첫 번째 호출은 성공하고 다른 호출은 실패합니다. 자세한 내용은 DISM API 사용을 참조하세요.
예제
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
요구 사항
| 요구 사항 | 설명 |
|---|---|
| 지원되는 호스트 플랫폼: | 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 |