DismEnableFeature 함수
이미지의 기능을 사용하도록 설정합니다. 기능은 이름으로 식별되며 필요에 따라 패키지에 연결할 수 있습니다.
구문
HRESULT WINAPI DismEnableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_In_ BOOL LimitAccess,
_In_opt_ PCWSTR *SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_ BOOL EnableAll,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
매개 변수
Session [in]
유효한 DismSession입니다. DismSession은 이미지와 연결되어야 합니다.
DismOpenSession을 사용하여 세션을 이미지와 연결할 수 있습니다.
FeatureName [in]
사용 중인 기능의 이름입니다. 둘 이상의 기능을 사용하도록 설정하려면 각 기능 이름을 세미콜론으로 구분합니다.
Identifier [in, optional]
선택 사항입니다. .cab 파일의 절대 경로 또는 사용할 기능의 부모 패키지에 대한 패키지 이름입니다.
PackageIdentifier [in, optional]
선택 사항입니다. 유효한 DismPackageIdentifier 열거형 값입니다.
Identifier 매개 변수가 패키지 이름을 가리키는 경우 DismPackageName을 사용해야 하며 Identifier가 .cab 파일의 절대 경로를 가리키는 경우 DismPackagePath를 사용해야 합니다.
Identifier 필드가 NULL이 아닌 경우 유효한 PackageIdentifier 매개 변수를 지정해야 합니다.
Identifier 필드가 NULL이면 PackageIdentifier 매개 변수가 무시됩니다.
LimitAccess [in]
이 매개 변수는 Windows 8.1 및 Windows Server 2012 R2부터 무시됩니다.
Windows 8 및 Windows Server 2012:
다른 지정된 위치에 없는 경우 파일을 다운로드하기 위한 원본 위치로 WU(Windows Update)에 연결할지 여부를 나타내는 부울 값입니다. WU를 확인하기 전에 DISM은 그룹 정책에 따라 제공된 SourcePaths 및 레지스트리에 지정된 위치에서 파일을 확인합니다. 기능을 사용하도록 설정하는 데 필요한 파일이 아직 컴퓨터에 있는 경우 이 플래그는 무시됩니다.
| 값 | 설명 |
|---|---|
| TRUE | WU에서 복구 파일을 확인하지 마세요. |
| FALSE | 기본값 WU에서 복구 파일을 확인하세요. |
SourcePaths [in, optional]
이 매개 변수는 Windows 8.1 및 Windows Server 2012 R2부터 무시됩니다.
Windows 8 및 Windows Server 2012:
기능을 사용하도록 설정하는 데 필요한 파일을 확인할 원본 위치 목록입니다.
SourcePathCount [in, optional]
이 매개 변수는 Windows 8.1 및 Windows Server 2012 R2부터 무시됩니다.
Windows 8 및 Windows Server 2012:
지정된 원본 위치의 수입니다.
EnableAll [in]
기능의 모든 종속성을 사용하도록 설정합니다. 지정된 기능 또는 해당 종속성 중 하나를 사용하도록 설정할 수 없는 경우 어느 것도 기존 상태에서 변경되지 않습니다.
| 값 | 설명 |
|---|---|
| TRUE | 기능의 모든 종속성을 사용하도록 설정합니다. |
| FALSE | 지정된 기능만 사용하도록 설정합니다. |
CancelEvent [in, optional]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다.
CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트 정의 DismProgressCallback에 대한 포인터입니다.
UserData [in, optional]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
반환 값
성공 시 S_OK을(를) 반환합니다.
설명
이 기능이 파운데이션 패키지에 있는 경우 패키지 정보를 지정할 필요가 없습니다. 기능이 이미지에 이미 설치된 선택적 패키지 또는 기능 팩에 있는 경우 Identifier 매개 변수에서 패키지 이름을 지정하고 DismPackageName을 PackageIdentifier로 지정합니다. 부모 기능이 활성화되지 않아 기능을 사용하도록 설정할 수 없는 경우 특수 오류 코드가 반환됩니다. 지정된 기능을 사용하도록 설정할 때 EnableAll을 사용하여 부모 기능을 사용하도록 설정하거나 DismGetFeatureParent를 사용하여 부모 기능을 열거하고 먼저 사용하도록 설정할 수 있습니다.
중요
사용하도록 설정할 기능이 파운데이션 패키지의 구성 요소가 아닌 경우 기능을 사용하도록 설정하기 전에 DismAddPackage를 사용하여 부모 선택적 패키지를 추가해야 합니다. Identifier 매개 변수의 이미지에 추가되지 않은 선택적 패키지의 .cab 파일 경로를 지정하지 마세요. 추가되지 않은 패키지를 지정하고 DismPackagePath를 PackageIdentifier로 지정하면 함수가 성공적으로 완료되지만 기능이 사용하도록 설정되지 않습니다.
참고
LimitAccess, SourcePaths, SourcePathCount 및 EnableAll은 Windows 8 및 Windows Server 2012에서만 지원됩니다.
예제
HRESULT hr = S_OK;
hr = DismEnableFeature(Session, “WindowsMediaPlayer”, NULL, PackageNone, TRUE, NULL, 0, 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 |