SetupOpenAppendInfFileA, 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 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'NULL, FileName pointe vers une chaîne null-terminated contenant le nom (et éventuellement le chemin) 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. Si FileName est 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 (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
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’erreur étendues, appelez GetLastError.
Si fileName n’a pas été spécifié et qu’aucune valeur LayoutFile n’a été spécifiée dans la section Version du fichier INF existant, GetLastError retourne ERROR_INVALID_DATA.
Remarques
Cette fonction nécessite un fichier Windows INF. Certains formats de fichiers INF plus anciens peuvent ne pas être pris en charge. Dans ce cas, la fonction retourne FAUX et GetLastError retourne ERROR_INVALID_PARAMETER. L’objectif principal de cette fonction est de combiner un fichier INF avec les informations d’emplacement de 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.
Note
L’en-tête setupapi.h définit SetupOpenAppendInfFile 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 |