Fonction DismCommitImage
Valide les modifications apportées à une image Windows dans un fichier .wim ou .vhd monté. L’image doit être montée à l’aide de DismMountImage.
Syntaxe
HRESULT WINAPI DismCommitImage(
_In_ DismSession Session,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Paramètres
Session [entrée]
Une DismSession valide. La DismSession doit être associée à une image. Vous pouvez associer une session à une image à l’aide de DismOpenSession.
Indicateurs [in]
Indicateurs de validation à utiliser pour cette opération. Pour plus d’informations sur les indicateurs de montage, consultez Constantes de l’API DISM.
CancelEvent [entrée, facultatif]
Indicateurs de validation à utiliser pour cette opération. Pour plus d’informations sur les indicateurs de montage, consultez Constantes de l’API DISM.
Progress [entrée, facultatif]
Optionnel. Pointeur vers un DismProgressCallback défini par le client.
UserData [entrée, facultatif]
Optionnel. Données personnalisées définies par l’utilisateur.
Valeur retournée
Retourne S_OK en cas de réussite.
Retourne E_INVALIDARG si la DismSession n’est pas valide ou si la DismSession n’est pas associée à une image montée.
Notes
La fonction DismCommitImage ne démonte pas l’image.
Notes
DismCommitImage ne peut être utilisé que sur une image montée dans l’infrastructure DISM. Elle ne s’applique pas aux images montées par un autre outil, tel que l’outil DiskPart, qui sont prises en charge à l’aide de DismOpenSession. Vous devez utiliser DismMountImage pour monter une image au sein de l’infrastructure DISM.
Exemple
HRESULT hr = S_OK;
hr = DismCommitImage(Session, 0, NULL, NULL, NULL);
Spécifications
| Condition requise | Description |
|---|---|
| Plateformes hôtes prises en charge | L’API DISM peut être utilisée sur n’importe quel système d’exploitation pris en charge par le Kit de déploiement et d’évaluation Windows (Windows ADK). Pour plus d’informations, consultez les Informations de référence technique Windows ADK. |
| Plateformes d’images prises en charge | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, environnement de préinstallation Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | DismAPI.h |
| Bibliothèque | DismAPI.lib |
| DLL | DismAPI.dll |