SetupGetIntField, 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 SetupGetIntField récupère une valeur entière à partir du champ spécifié d’une ligne dans un fichier INF.
Syntaxe
WINSETUPAPI BOOL SetupGetIntField(
[in] PINFCONTEXT Context,
[in] DWORD FieldIndex,
[out] PINT IntegerValue
);
Paramètres
[in] Context
Pointeur vers le contexte d’une ligne dans un fichier INF.
[in] FieldIndex
Index de base 1 du champ dans la ligne spécifiée à partir de laquelle l’entier doit être récupéré.
Un FieldIndex de 0 peut être utilisé pour récupérer une clé entière (par exemple, considérez la ligne INF suivante, 431 = 1, 2, 4. La valeur 431 est placée dans la variable pointée par IntegerValue si SetupGetIntField a été appelé avec un FieldIndex de 0).
[out] IntegerValue
Pointeur vers une variable qui reçoit l’entier. Si le champ n’est pas un entier, la fonction échoue et un appel à GetLastError retourne ERROR_INVALID_DATA.
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
Le champ entier peut commencer par un signe positif (+) ou négatif (-). Il sera interprété comme un nombre décimal, sauf s’il est préfixé dans le fichier avec 0x ou 0X, auquel cas il est hexadécimal.
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) |