Funzione DismCheckImageHealth
Controlla se l'immagine può essere serviziata o danneggiata.
Sintassi
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
);
Parametri
Sessione [in]
Una dismSession valida. La dismSession deve essere associata a un'immagine. È possibile associare una sessione a un'immagine usando DismOpenSession.
ScanImage [in]
Valore booleano che specifica se analizzare l'immagine o solo verificare la presenza di flag da un'analisi precedente.
| Valore | Descrizione |
|---|---|
| TRUE | Analizzare l'immagine e contrassegnarla se è danneggiata. |
| FALSE | Controllare se l'immagine è stata contrassegnata come danneggiata. È possibile usare questo valore se l'immagine è già stata analizzata. |
CancelEvent [in, facoltativo]
Facoltativa. È possibile impostare un CancelEvent per questa funzione per annullare l'operazione in corso quando viene segnalato dal client. Se l'evento CancelEvent viene ricevuto in una fase quando l'operazione non può essere annullata, l'operazione continuerà e restituirà un codice di operazione riuscita. Se l'evento CancelEvent viene ricevuto e l'operazione viene annullata, lo stato dell'immagine è sconosciuto. È necessario verificare lo stato dell'immagine prima di continuare o annullare le modifiche e ricominciare.
Stato [in, facoltativo]
Facoltativa. Puntatore a un dismProgressCallback definito dal client.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
ImageHealth [out]
Puntatore all'enumerazione DismImageHealthState . Il valore di enumerazione viene impostato durante questa operazione.
Valore restituito
Se l'esito è positivo, restituisce S_OK .
Commenti
Se ScanImage è impostato su True, questa funzione richiederà più tempo per terminare.
Esempio
HRESULT hr = S_OK;
DismImageHealthState state;
hr = DismCheckImageHealth(Session, TRUE, NULL, NULL, NULL, &state);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate | L'API GESTIONE e manutenzione immagini distribuzione può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per altre informazioni, vedere la Guida tecnica di Windows ADK. |
| Piattaforme di immagini supportate | Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Intestazione | DismAPI.h |
| Libreria | DismAPI.lib |
| DLL | DismAPI.dll |