Fonction SetupUninstallOEMInfA (setupapi.h)

Article
08/26/2023

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]

La fonction SetupUninstallOEMInf désinstalle un fichier .inf spécifié et tout fichier .pnf associé. Si le fichier .inf a été installé avec un catalogue pour la signature des pilotes, le catalogue est également supprimé. Un appelant de cette fonction doit disposer de privilèges d’administration, sinon la fonction échoue.

Syntaxe

WINSETUPAPI BOOL SetupUninstallOEMInfA(
  [in] PCSTR InfFileName,
  [in] DWORD Flags,
  [in] PVOID Reserved
);

Paramètres

[in] InfFileName

Nom de fichier, sans chemin d’accès, du fichier .inf dans le répertoire Windows Inf qui doit être désinstallé.

[in] Flags

Ce paramètre peut être défini comme suit.

Indicateur	Signification
SUOI_FORCEDELETE 0x0001	La fonction SetupUninstallOEMInf vérifie d’abord si des appareils sont installés à l’aide du fichier .inf. Un appareil n’a pas besoin d’être présent pour être détecté comme utilisant le fichier .inf. Si cet indicateur n’est pas défini et que la fonction recherche un appareil actuellement installé qui a été installé à l’aide de ce fichier .inf, le fichier .inf n’est pas supprimé. Si cet indicateur est défini, le fichier .inf est supprimé si la fonction trouve un appareil qui a été installé avec ce fichier .inf. Note Cet indicateur s’applique uniquement aux architectures x86, amd64 et ia64. Il est ignoré sur toutes les autres architectures. Note Si le package de pilotes contient des fichiers copiés dans un DestinationDir qui utilise un DirId de 13, cet indicateur de force est ignoré. Note Il est recommandé d’utiliser DiUninstallDriver pour supprimer un package de pilotes au lieu d’utiliser cet indicateur.

Indicateur

Signification

SUOI_FORCEDELETE
0x0001

La fonction SetupUninstallOEMInf vérifie d’abord si des appareils sont installés à l’aide du fichier .inf. Un appareil n’a pas besoin d’être présent pour être détecté comme utilisant le fichier .inf.

Si cet indicateur n’est pas défini et que la fonction recherche un appareil actuellement installé qui a été installé à l’aide de ce fichier .inf, le fichier .inf n’est pas supprimé.

Si cet indicateur est défini, le fichier .inf est supprimé si la fonction trouve un appareil qui a été installé avec ce fichier .inf.

Note Cet indicateur s’applique uniquement aux architectures x86, amd64 et ia64. Il est ignoré sur toutes les autres architectures.

Note Si le package de pilotes contient des fichiers copiés dans un DestinationDir qui utilise un DirId de 13, cet indicateur de force est ignoré.

Note Il est recommandé d’utiliser DiUninstallDriver pour supprimer un package de pilotes au lieu d’utiliser cet indicateur.

[in] Reserved

Définissez sur null.

Valeur retournée

Cette fonction retourne WINSETUPAPI BOOL.

Remarques

Notes

L’en-tête setupapi.h définit SetupUninstallOEMInf comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	setupapi.h
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll
Ensemble d’API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi