Funzione DismRestoreImageHealth
Ripristina un'immagine danneggiata identificata come ripristinabile da DismCheckImageHealth.
Sintassi
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
);
Parametri
Sessione [in]
DismSession valido. L'oggetto DismSession deve essere associato a un'immagine. È possibile associare una sessione a un'immagine usando DismOpenSession.
SourcePaths [in, facoltativo]
Facoltativa. Elenco dei percorsi di origine da verificare per la correzione dei file.
SourcePathCount [in, facoltativo]
Facoltativa. Numero di posizioni di origine specificate.
LimitAccess [in]
Valore booleano che indica se la funzione DismRestoreImageHealth deve contattare Windows Update (WU) come percorso di origine per il download di file di ripristino. Prima di controllare WU, DISM verificherà la presenza dei file nei Percorsi di origine forniti e in qualsiasi percorso specificato nel Registro di sistema tramite Criteri di gruppo. Se i file necessari per abilitare la funzionalità vengono trovati in questi altri percorsi specificati, questo flag viene ignorato.
| Valore | Descrizione |
|---|---|
| TRUE | Non controllare WU per i file di ripristino. |
| FALSE | Valore predefinito. Controllare WU per ripristinare i file. |
CancelEvent [in, facoltativo]
Facoltativa. È possibile impostare CancelEvent per questa funzione per annullare l'operazione in corso quando viene segnalato dal client. Se cancelEvent viene ricevuto in una fase quando l'operazione non può essere annullata, l'operazione continuerà e restituirà un codice di esito positivo. Se cancelEvent viene ricevuto e l'operazione viene annullata, lo stato dell'immagine è sconosciuto. È necessario verificare lo stato dell'immagine prima di continuare o ignorare le modifiche e ricominciare.
Stato [in, facoltativo]
Facoltativa. Puntatore a un client definito da DismProgressCallback.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
Valore restituito
Restituisce S_OK sull'esito positivo.
Commenti
Eseguire DismCheckImageHealth per determinare se l'immagine è danneggiata e se l'immagine è ripristinabile. Se DismCheckImageHealth restituisce DismImageRepairable, la funzione DismRestoreImageHealth può ripristinare l'immagine.
Se un file di ripristino non viene trovato in nessuna delle posizioni specificate dal parametro SourcePaths o dai percorsi del percorso nel Registro di sistema specificato da Criteri di gruppo, la funzione DismRestoreImageHealth contatta WU per verificare la presenza di un file di ripristino a meno che il parametro LimitAccess non sia impostato su TRUE.
Esempio
HRESULT hr = S_OK;
hr = DismRestoreImageHealth(Session, NULL, 0, TRUE, NULL, NULL, NULL);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate | L'API DISM può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per altre informazioni, vedere Informazioni di riferimento tecnico su 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 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | DismAPI.h |
| Libreria | DismAPI.lib |
| DLL | DismAPI.dll |