Función DismAddCapability
Agrega una funcionalidad a una imagen.
Sintaxis
HRESULT WINAPI DismAddCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_In_ BOOL LimitAccess,
_In_ PCWSTR* SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parámetros
Sesión [in]
Valor de DismSession válido. DismSession debe estar asociado a una imagen. Puede asociar una sesión a una imagen mediante DismOpenSession.
Nombre [in]
Nombre de la funcionalidad que se va a agregar.
LimitAccess [in]
La marca indica si se debe ponerse en contacto con WU/WSUS como ubicación de origen para descargar la carga de una funcionalidad. Si existe la carga de la capacidad que se va a agregar, se omite la marca .
SourcePaths [in]
Una lista de ubicaciones de origen. La función buscará los archivos de carga quitados de las ubicaciones especificadas en SourcePaths y, si no se encuentra, continúe la búsqueda poniéndose en contacto con WU/WSUS según el parámetro LimitAccess.
SourcePathCount [in, opcional]
Recuento de entradas en SourcePaths.
CancelEvent [entrada, opcional]
Se trata de un identificador de un evento para la cancelación.
Progress [entrada, opcional]
Puntero a una función de devolución de llamada definida por el cliente para notificar el progreso.
UserData [entrada, opcional]
Datos personalizados definidos por el usuario. Se devolverá al usuario a través de la devolución de llamada.
Valor devuelto
Si se descarga correctamente, devuelve S_OK .
Comentarios
Use esta función para agregar una funcionalidad.
Ejemplo
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, NULL, NULL, NULL);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas host soportadas | La API de DISM puede usarse en cualquier sistema operativo que el Windows Assessment and Deployment Kit (Windows ADK) admita. Para obtener más información, consulta la Referencia técnica de Windows ADK. |
| Plataformas de imágenes soportadas | Windows 10, Windows Server 2016 |
| Cliente mínimo compatible | Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| Archivo DLL | DismAPI.dll |