SetupEnumInfSectionsA, fonction (setupapi.h)

Article
11/20/2024

[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 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 à interroger.

[in] Index

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

[out, optional] Buffer

Pointeur vers une mémoire tampon qui reçoit le nom de la 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. Cette technique vous permet d’é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 Remarques.

[in] Size

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

[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 comme nombre de caractères requis pour stocker le nom de la section, y compris la fin null caractère.

Valeur de retour

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’erreur étendues, 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 retourne le nom une seule fois à l’aide d’un index d’énumération unique. Pour renvoyer tous les noms de section dans le fichier INF, appelez la fonction à partir d’un index d’énumération de 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 GetLastError retourne ERROR_NO_MORE_ITEMS. Votre application ne doit pas compter sur les noms de section retournés dans un ordre quelconque en fonction de l’index d’énumération.

Note

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. 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-1 (introduit dans Windows 10, version 10.0.14393)

Partager via