SetupOpenInfFileA, fonction (setupapi.h)
[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 SetupOpenInfFile ouvre un fichier INF et retourne un handle à celui-ci.
Syntaxe
WINSETUPAPI HINF SetupOpenInfFileA(
[in] PCSTR FileName,
[in] PCSTR InfClass,
[in] DWORD InfStyle,
[in] PUINT ErrorLine
);
Paramètres
[in] FileName
Pointeur vers une chaîne terminée par null contenant le nom (et le chemin facultatif) du fichier INF à ouvrir. Si le nom de fichier ne contient pas de caractères de séparateur de chemin d’accès, il est recherché, d’abord dans le répertoire %windir%\inf, puis dans le répertoire %windir%\system32. Si le nom de fichier contient des caractères de séparateur de chemin d’accès, il est supposé être une spécification de chemin d’accès complet et aucun traitement supplémentaire n’est effectué sur celui-ci.
[in] InfClass
Pointeur facultatif vers une chaîne terminée par null contenant la classe de fichier INF souhaitée. Cette chaîne doit correspondre à la valeur Class de la section version
[in] InfStyle
Style de fichier INF à ouvrir ou rechercher. Ce paramètre peut être une combinaison des indicateurs suivants.
INF_STYLE_OLDNT
Format de fichier INF hérité.
INF_STYLE_WIN4
Format de fichier Windows INF.
[in] ErrorLine
Pointeur facultatif vers une variable vers laquelle cette fonction retourne le numéro de ligne (basé sur 1) où une erreur s’est produite lors du chargement du fichier INF. Cette valeur est généralement fiable uniquement si GetLastError ne retourne pas ERROR_NOT_ENOUGH_MEMORY. Si une condition de mémoire insuffisante se produit, ErrorLine peut être 0.
Valeur de retour
La fonction retourne un handle au fichier INF ouvert s’il réussit. Sinon, la valeur de retour est INVALID_HANDLE_VALUE. Les informations d’erreur étendues peuvent être récupérées par un appel à GetLastError.
Remarques
Si la charge échoue, car le type de fichier INF ne correspond pas InfClass, la fonction retourne INVALID_HANDLE_VALUE et un appel à GetLastError retourne ERROR_CLASS_MISMATCH.
Si plusieurs styles de fichier INF sont spécifiés, le style du fichier INF ouvert peut être déterminé en appelant la fonction SetupGetInfInformation.
Étant donné qu’il peut y avoir plusieurs GUID de classe portant le même nom de classe, les appelants intéressés par les fichiers INF d’une classe particulière (autrement dit, un GUID de classe particulier) doivent récupérer la valeur ClassGUID du fichier INF en appelant SetupQueryInfVersionInformation.
Pour les fichiers INF hérités, la chaîne InfClass
Note
L’en-tête setupapi.h définit SetupOpenInfFile 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-inf-l1-1-0 (introduit dans Windows 8) |