Fonction DismRemovePackage
Supprime un package d’une image.
Syntaxe
HRESULT WINAPI DismRemovePackage(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_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 la DismOpenSession.
Identificateur [entrée]
Chemin d’accès absolu à un fichier .cab ou nom du package, en fonction de la valeur du paramètre PackageIdentifier.
PackageIdentifier [entrée]
facultatif. Valeur d’énumération DismPackageIdentifier valide.
| Valeur | Description |
|---|---|
| PackageName | Utilisez cette valeur lorsque vous souhaitez spécifier un package à l’aide du nom du package. |
| PackagePath | Utilisez cette valeur lorsque vous souhaitez spécifier un package à l’aide d’un chemin d’accès absolu à un fichier .cab. |
| PackageNone | N’est pas une valeur valide pour cette fonction. |
CancelEvent [entrée, facultatif]
Optionnel. Vous pouvez définir un CancelEvent pour cette fonction afin d’annuler l’opération en cours lorsqu’elle est signalée par le client. Si l’événement CancelEvent est reçu à un stade où l’opération ne peut pas être annulée, l’opération continue et retourne un code de réussite. Si l’événement CancelEvent est reçu et que l’opération est annulée, l’état de l’image est inconnu. Vous devez vérifier l’état de l’image avant de continuer ou d’ignorer les modifications et de recommencer.
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
Renvoie S_OK en cas de réussite.
Notes
La fonction DismRemovePackage ne prend pas en charge les fichiers .msu.
Exemple
HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, 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 |