DismDisableFeature 함수
현재 이미지에서 기능을 비활성화합니다.
구문
HRESULT WINAPI DismDisableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR PackageName,
_In_ BOOL RemovePayload,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
매개 변수
Session [in]
유효한 DismSession입니다. DismSession은 이미지와 연결되어야 합니다. DismOpenSession을 사용하여 세션을 이미지와 연결할 수 있습니다.
FeatureName [in]
비활성화할 기능의 이름입니다. 하나보다 많은 기능을 비활성화하려면 각 기능 이름을 세미콜론으로 구분합니다.
PackageName [in, 선택 사항]
선택 사항입니다. 기능이 속한 부모 패키지의 이름입니다. 패키지가 지정되지 않은 경우 기본 Windows Foundation 패키지가 사용됩니다.
RemovePayload [in]
이 매개 변수는 Windows 8.1 및 Windows Server 2012 R2부터 지원되지 않습니다.
Windows 8 및 Windows Server 2012:
기능을 활성화하는 데 필요한 파일을 제거할지 여부를 지정하는 부울 값입니다.
| 값 | 설명 |
|---|---|
| TRUE | 파일이 제거됩니다. |
| FALSE | 파일이 제거되지 않습니다. |
CancelEvent [in, 선택 사항]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다. CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트 정의 DismProgressCallback에 대한 포인터입니다.
UserData [in, optional]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
반환 값
성공 시 S_OK을(를) 반환합니다.
예제
HRESULT hr = S_OK;
hr = DismDisableFeature(Session, "WindowsMediaPlayer", NULL, 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 |