SetupQueryInfFileInformationA, 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 SetupQueryInfFileInformation retourne un nom de fichier INF d’une structure SP_INF_INFORMATION à une mémoire tampon.
Syntaxe
WINSETUPAPI BOOL SetupQueryInfFileInformationA(
[in] PSP_INF_INFORMATION InfInformation,
[in] UINT InfIndex,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Paramètres
[in] InfInformation
Pointeur vers une structure
[in] InfIndex
Index du nom de fichier INF constituant à récupérer. Cet index peut se trouver dans la plage [0, InfInformation.InfCount). Cela signifie que les valeurs sont nulles, mais pas comprises, InfInformation.InfCount sont valides.
[in, out] ReturnBuffer
Si ce n’est pas NULL, ReturnBuffer est un pointeur vers une mémoire tampon dans laquelle cette fonction retourne le nom de fichier INF complet. Vous devez utiliser une chaîne null-terminated. La chaîne null-terminated 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. Consultez la section Remarques. Cette technique vous permet d’éviter les erreurs en raison d’une taille de mémoire tampon insuffisante. Ce paramètre peut être NULL.
[in] ReturnBufferSize
Taille de la mémoire tampon pointée par le paramètre ReturnBuffer, en caractères. Cela inclut la la marque de fin de null.
[in, out] RequiredSize
Si ce n’est pas le cas
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.
Remarques
Si cette fonction est appelée avec un ReturnBuffer de 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 dans ce cas, 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.
Note
L’en-tête setupapi.h définit SetupQueryInfFileInformation en tant qu’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 |