SetupEnumInfSectionsA, fonction (setupapi.h)

[Cette fonction peut être utilisée 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 installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les pilotes de périphérique.]

La fonction SetupEnumInfSections récupère les noms de section à partir d’un fichier INF.

Syntaxe

WINSETUPAPI BOOL SetupEnumInfSectionsA(
  [in]            HINF InfHandle,
  [in]            UINT Index,
  [out, optional] PSTR Buffer,
  [in]            UINT Size,
  [out, optional] UINT *SizeNeeded
);

Paramètres

[in] InfHandle

Gérez le fichier INF qui doit être interrogé.

[in] Index

Index de base zéro du nom de section à récupérer. Cet index peut ne pas correspondre à l’ordre des sections telles qu’elles apparaissent dans le fichier INF.

[out, optional] Buffer

Pointeur vers une mémoire tampon qui reçoit le nom de section. 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 le nom. À l’aide de cette technique, vous pouvez éviter les erreurs provoquées par une taille de mémoire tampon insuffisante. Ce paramètre est facultatif. Pour plus d'informations, consultez la section Notes.

[in] Size

Taille de la mémoire tampon pointée par ReturnBuffer en caractères. Ce nombre inclut le caractère NULL de fin.

[out, optional] SizeNeeded

Pointeur vers un emplacement qui reçoit la taille requise de la mémoire tampon pointée par ReturnBuffer. La taille est spécifiée en tant que nombre de caractères requis pour stocker le nom de section, y compris le caractère NULL de fin.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

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

GetLastError retourne ERROR_NO_MORE_ITEMS si la valeur de EnumerationIndex est supérieure ou égale au nombre de noms de sections dans le fichier INF.

Remarques

Cette fonction peut énumérer tous les noms de section uniques dans le fichier INF. Si un nom de section apparaît plusieurs fois dans un fichier INF, la fonction ne retourne le nom qu’une seule fois à l’aide d’un seul index d’énumération. Pour renvoyer tous les noms de section dans le fichier INF, appelez la fonction commençant par un index d’énumération égal à zéro, puis effectuez des appels répétés à la fonction tout en incrémentant l’index jusqu’à ce que la fonction retourne FALSE et que GetLastError retourne ERROR_NO_MORE_ITEMS. Votre application ne doit pas s’appuyer sur les noms de section retournés dans un ordre quelconque basé sur l’index d’énumération.

Notes

L’en-tête setupapi.h définit SetupEnumInfSections 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. La combinaison 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
Ensemble d’API	ext-ms-win-setupapi-inf-l1-1-1 (introduit dans Windows 10, version 10.0.14393)