Fonction SetupGetInfFileListA (setupapi.h)
[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 SetupGetInfFileList retourne une liste de fichiers INF situés dans un répertoire spécifié par l’appelant à une mémoire tampon fournie par appel.
Syntaxe
WINSETUPAPI BOOL SetupGetInfFileListA(
[in] PCSTR DirectoryPath,
[in] DWORD InfStyle,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Paramètres
[in] DirectoryPath
Pointeur facultatif vers une chaîne terminée par null contenant le chemin d’accès du répertoire dans lequel effectuer la recherche. Si cette valeur est NULL, le répertoire %windir%\inf est utilisé.
[in] InfStyle
Type de fichier INF à rechercher. Il peut s’agir d’une combinaison des indicateurs suivants.
INF_STYLE_OLDNT
Format de fichier INF hérité.
INF_STYLE_WIN4
Format de fichier INF Windows.
[in, out] ReturnBuffer
Si ce n’est pas NULL, pointe vers une mémoire tampon dans laquelle cette fonction retourne la liste de tous les fichiers INF des styles souhaités qui ont été trouvés dans le sous-répertoire spécifié. Les noms de fichiers sont terminés par null, avec une valeur Null supplémentaire à la fin de la liste. La chaîne terminée par null ne doit pas dépasser la taille de la mémoire tampon de destination. Vous pouvez appeler la fonction une fois pour obtenir la taille de mémoire tampon requise, allouer la mémoire nécessaire, puis appeler la fonction une deuxième fois pour récupérer les données. À l’aide de cette technique, vous pouvez éviter les erreurs dues à une taille de mémoire tampon insuffisante. Les noms de fichiers n’incluent pas le chemin d’accès. Consultez la section Notes.
[in] ReturnBufferSize
Taille de la mémoire tampon pointée vers le paramètre ReturnBuffer , en caractères. Cela inclut le terminateur null . Si ReturnBuffer n’est pas spécifié, ReturnBufferSize est ignoré.
[in, out] RequiredSize
Si ce n’est pas NULL, pointe vers une variable dans laquelle cette fonction retourne la taille requise pour la mémoire tampon pointée par le paramètre ReturnBuffer , en caractères. Cela inclut le terminateur null . Si ReturnBuffer est spécifié et que la taille nécessaire est supérieure à ReturnBufferSize, la fonction échoue et un appel à GetLastError retourne ERROR_INSUFFICIENT_BUFFER.
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.
Remarques
Si cette fonction est appelée avec un ReturnBuffer null et un ReturnBufferSize de zéro, la fonction place la taille de mémoire tampon nécessaire pour contenir les données spécifiées dans la variable pointée par RequiredSize. Si la fonction réussit cette opération, la valeur de retour est une valeur différente de zéro. Sinon, la valeur de retour est zéro et les informations d’erreur étendues peuvent être obtenues en appelant GetLastError.
Si plusieurs styles de fichier INF sont retournés par cette fonction, le style d’un fichier INF particulier peut être déterminé en appelant la fonction SetupGetInfInformation
Notes
L’en-tête setupapi.h définit SetupGetInfFileList 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 |