Funzione DismCommitImage
Esegue il commit delle modifiche apportate a un'immagine di Windows in un file con estensione wim o vhd montato. L'immagine deve essere montata usando DismMountImage.
Sintassi
HRESULT WINAPI DismCommitImage(
_In_ DismSession Session,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parametri
Sessione [in]
Una dismSession valida. La dismSession deve essere associata a un'immagine. È possibile associare una sessione a un'immagine usando DismOpenSession.
Flag [in]
Flag di commit da utilizzare per questa operazione. Per altre informazioni sui flag di montaggio, vedere Costanti DELL'API GESTIONE e manutenzione e distribuzione.
CancelEvent [in, facoltativo]
Flag di commit da utilizzare per questa operazione. Per altre informazioni sui flag di montaggio, vedere Costanti DELL'API GESTIONE e manutenzione e distribuzione.
Stato [in, facoltativo]
Facoltativa. Puntatore a un dismProgressCallback definito dal client.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
Valore restituito
Se l'esito è positivo, restituisce S_OK .
Restituisce E_INVALIDARG se DismSession non è valido o se La sessione dism non è associata a un'immagine montata.
Commenti
La funzione DismCommitImage non smonta l'immagine.
Nota
DismCommitImage può essere usato solo in un'immagine montata all'interno dell'infrastruttura DISM. Non si applica alle immagini montate da un altro strumento, ad esempio lo strumento DiskPart, gestito tramite DismOpenSession. È necessario usare DismMountImage per montare un'immagine all'interno dell'infrastruttura DISM.
Esempio
HRESULT hr = S_OK;
hr = DismCommitImage(Session, 0, NULL, NULL, NULL);
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 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 4.0, 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 |