Función DismRestoreImageHealth
Repara una imagen dañada identificada como reparable por DismCheckImageHealth.
Sintaxis
HRESULT WINAPI DismRestoreImageHealth(
_In_ DismSession Session,
_In_opt_ PCWSTR *SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_ BOOL LimitAccess,
_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.
SourcePaths [in, optional]
Opcional. Lista de ubicaciones de origen para comprobar si hay archivos de reparación.
SourcePathCount [in, opcional]
Opcional. Número de ubicaciones de origen especificadas.
LimitAccess [in]
Valor booleano que indica si la función DismRestoreImageHealth debe ponerse en contacto con Windows Update (WU) como ubicación de origen para descargar archivos de reparación. Antes de comprobar WU, DISM comprobará los archivos de sourcePath proporcionados y en las ubicaciones especificadas en el registro por directiva de grupo. Si los archivos necesarios para habilitar la característica se encuentran en estas otras ubicaciones especificadas, se omite esta marca.
| Valor | Descripción |
|---|---|
| TRUE | No compruebe wu para ver si hay archivos de reparación. |
| FALSE | Predeterminada. Compruebe WU para ver si hay archivos de reparación. |
CancelEvent [entrada, opcional]
Opcional. Puede establecer un valor CancelEvent para esta función con el fin de cancelar la operación en curso cuando el cliente lo indique. Si CancelEvent se recibe en una fase en la que no se puede cancelar la operación, esta continuará y devolverá un código correcto. Si se recibe CancelEvent y se cancela la operación, el estado de la imagen será desconocido. Debe comprobar el estado de la imagen antes de continuar o descartar los cambios y volver a empezar.
Progress [entrada, opcional]
Opcional. Puntero a un valor DismProgressCallback definido por el cliente.
UserData [entrada, opcional]
Opcional. Datos personalizados definidos por el usuario.
Valor devuelto
Devuelve S_OK si se realiza correctamente.
Comentarios
Ejecute DismCheckImageHealth para determinar si la imagen está dañada y si la imagen es reparable. Si DismCheckImageHealth devuelve DismImageRepairable, la función DismRestoreImageHealth puede reparar la imagen.
Si no se encuentra un archivo de reparación en ninguna de las ubicaciones especificadas por el parámetro SourcePaths o las rutas de acceso de ubicación del registro especificadas por directiva de grupo, la función DismRestoreImageHealth se pondrá en contacto con WU para comprobar si hay un archivo de reparación a menos que el parámetro LimitAccess esté establecido en TRUE.
Ejemplo
HRESULT hr = S_OK;
hr = DismRestoreImageHealth(Session, NULL, 0, TRUE, 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 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| Archivo DLL | DismAPI.dll |