DismRemoveCapability function

Adds a capability to an image.

Syntax

HRESULT WINAPI DismRemoveCapability(
  _In_     DismSession             Session,
  _In_     PCWSTR                  Name,
  _In_opt_ HANDLE                  CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK  Progress,
  _In_opt_ PVOID                   UserData
);

Parameters

Session [in]
A valid DismSession. The DismSession must be associated with an image. You can associate a session with an image by using the DismOpenSession.

Name [in]
The name of the capability that is being removed

CancelEvent [in, optional]
This is a handle to an event for cancellation.

Progress [in, optional]
Pointer to a client defined callback function to report progress.

UserData [in, optional]
User defined custom data. This will be passed back to the user through the callback.

Return value

Returns S_OK on success.

Remarks

Use this function to remove a capability.

Example

HRESULT hr = S_OK;
hr = DismRemoveCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, NULL, NULL, NULL);

Requirements

Requirement Description
Supported host platforms DISM API can be used on any operating system supported by the Windows Assessment and Deployment Kit (Windows ADK). For more information, see the Windows ADK Technical Reference.
Supported image platforms Windows 10, Windows Server 2016
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Header DismAPI.h
Library DismAPI.lib
DLL DismAPI.dll

See also

DismAddDriver

DismEnableFeature

DismGetPackages

DismGetPackageInfo

DismRemovePackage

DismPackage

DismPackageInfo

DismPackageFeatureState