SetupUninstallOEMInfA, fonction (setupapi.h)

Article
11/20/2024

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer 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 les pilotes de signature, 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 à désinstaller.

[in] Flags

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

Drapeau	Signification
SUOI_FORCEDELETE 0x0001	La fonction SetupUninstallOEMInf vérifie d’abord s’il existe des appareils 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 trouve 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 installé avec ce fichier .inf. Remarque Cet indicateur s’applique uniquement aux architectures x86, amd64 et ia64. Elle est ignorée sur toutes les autres architectures. Remarque 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é. Remarque Il est recommandé d’utiliser DiUninstallDriver pour supprimer un package de pilotes au lieu d’utiliser cet indicateur.

Drapeau

Signification

SUOI_FORCEDELETE
0x0001

La fonction SetupUninstallOEMInf vérifie d’abord s’il existe des appareils 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 trouve 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 installé avec ce fichier .inf.

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

Remarque 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é.

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

[in] Reserved

Défini sur null .

Valeur de retour

Cette fonction retourne WINSETUPAPI BOOL.

Remarques

Note

L’en-tête setupapi.h définit SetupUninstallOEMInf comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’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

Partager via