Función DismCheckImageHealth
Comprueba si la imagen se puede atender o está dañada.
Sintaxis
HRESULT WINAPI WINAPI DismCheckImageHealth(
_In_ DismSession Session,
_In_ BOOL ScanImage,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData,
_Out_ DismImageHealthState *ImageHealth
);
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.
ScanImage [entrada]
Valor booleano que especifica si se va a examinar la imagen o simplemente buscar marcas de un examen anterior.
| Valor | Descripción |
|---|---|
| true | Examine la imagen y márquela si está dañada. |
| false | Compruebe si la imagen se ha marcado como dañada. Puede usar este valor si la imagen ya se ha examinado. |
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.
ImageHealth [salida]
Puntero a la enumeración DismImageHealthState. El valor de enumeración se establece durante esta operación.
Valor devuelto
Si se descarga correctamente, devuelve S_OK .
Comentarios
Si ScanImage está establecido en True, esta función tardará más tiempo en finalizar.
Ejemplo
HRESULT hr = S_OK;
DismImageHealthState state;
hr = DismCheckImageHealth(Session, TRUE, NULL, NULL, NULL, &state);
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 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| Archivo DLL | DismAPI.dll |