Fonction SetupOpenAppendInfFileA (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 SetupOpenAppendInfFile ajoute les informations d’un fichier INF à un fichier INF précédemment ouvert par SetupOpenInfFile.

Syntaxe

WINSETUPAPI BOOL SetupOpenAppendInfFileA(
  [in]      PCSTR FileName,
  [in]      HINF  InfHandle,
  [in, out] PUINT ErrorLine
);

Paramètres

[in] FileName

S’il n’est pas NULL, FileName pointe vers une chaîne terminée par null contenant le nom (et éventuellement le chemin d’accès) du fichier INF à ouvrir. Si le nom de fichier ne contient pas de caractères séparateurs 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 séparateurs de chemin d’accès, il est supposé être une spécification de chemin d’accès complète et aucun traitement supplémentaire n’est effectué sur celui-ci. Si FileName a la valeur NULL, le nom de fichier INF est récupéré à partir de la valeur LayoutFile de la section Version dans le fichier INF existant. La même logique de recherche est appliquée au nom de fichier récupéré à partir de la clé LayoutFile.

[in] InfHandle

Handle INF existant auquel ce fichier INF sera ajouté.

[in, out] ErrorLine

Pointeur facultatif vers une variable vers laquelle cette fonction retourne le numéro de ligne (1 base) où une erreur s’est produite lors du chargement du fichier INF. Cette valeur n’est généralement fiable que si GetLastError ne retourne pas ERROR_NOT_ENOUGH_MEMORY. Si une condition de mémoire insuffisante se produit, ErrorLine peut être 0.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Si FileName n’a pas été spécifié et qu’il n’y avait aucune valeur LayoutFile dans la section Version du fichier INF existant, GetLastError retourne ERROR_INVALID_DATA.

Remarques

Cette fonction nécessite un fichier INF Windows. Certains formats de fichiers INF plus anciens peuvent ne pas être pris en charge. Dans ce cas, la fonction retourne FALSE et GetLastError retourne ERROR_INVALID_PARAMETER. L’objectif main de cette fonction est de combiner un fichier INF avec les informations d’emplacement du fichier source contenues dans le fichier spécifié dans l’entrée LayoutFile de la section Version (généralement, LAYOUT). INF).

Le ERROR_WRONG_INF_STYLE peut également être retourné par SetupOpenAppendInfFile si le fichier INF utilise un format plus ancien.

Notes

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

Condition requise	Valeur
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

Voir aussi