Fonction DismDisableFeature
Désactive une fonctionnalité dans l’image actuelle.
Syntaxe
HRESULT WINAPI DismDisableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR PackageName,
_In_ BOOL RemovePayload,
_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.
FeatureName [in]
Nom de la fonctionnalité que vous souhaitez désactiver. Pour désactiver plusieurs fonctionnalités, séparez chaque nom de fonctionnalité par un point-virgule.
PackageName [in, facultatif]
facultatif. Nom du package parent dont la fonctionnalité fait partie. Si aucun package n’est spécifié, le package Windows Foundation par défaut est utilisé.
RemovePayload [in]
Ce paramètre n’est pas pris en charge à partir deWindows 8.1 et Windows Server 2012 R2.
Windows 8 et Windows Server 2012 :
Valeur booléenne spécifiant s’il faut supprimer les fichiers requis pour activer la fonctionnalité.
| Valeur | Description |
|---|---|
| TRUE | Les fichiers sont supprimés. |
| FALSE | Les fichiers ne sont pas supprimés. |
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
Retourne S_OK en cas de réussite.
Exemple
HRESULT hr = S_OK;
hr = DismDisableFeature(Session, "WindowsMediaPlayer", NULL, FALSE, 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 |