SetupQueryInfVersionInformationA, 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 SetupQueryInfVersionInformation retourne les informations de version du fichier INF d’une structure SP_INF_INFORMATION vers une mémoire tampon.

Syntaxe

WINSETUPAPI BOOL SetupQueryInfVersionInformationA(
  [in]      PSP_INF_INFORMATION InfInformation,
  [in]      UINT                InfIndex,
  [in]      PCSTR               Key,
  [in, out] PSTR                ReturnBuffer,
  [in]      DWORD               ReturnBufferSize,
  [in, out] PDWORD              RequiredSize
);

Paramètres

[in] InfInformation

Pointeur vers une structure SP_INF_INFORMATION précédemment retournée par un appel à la fonction SetupGetInfInformation SetupGetInfInformation.

[in] InfIndex

Index du fichier INF constituant à partir duquel récupérer les informations de version. 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] Key

Pointeur facultatif vers une chaîne null-terminated contenant le nom de clé dont la chaîne associée doit être récupérée. Si ce paramètre est NULL, toutes les clés de ressource sont copiées dans la mémoire tampon fournie. Chaque chaîne est -terminated, avec un null supplémentaire à la fin de la liste.

[in, out] ReturnBuffer

Si ce n’est pas NULL, ReturnBuffer pointe vers une mémoire tampon de caractères fournie par un appel dans laquelle cette fonction retourne le style de fichier INF. 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. Cette technique vous permet d’éviter les erreurs en raison d’une taille de mémoire tampon insuffisante. Consultez la section Remarques. Ce paramètre peut être NULL.

[in] ReturnBufferSize

Taille de la mémoire tampon pointée par le paramètre ReturnBuffer, en caractères. Ce nombre inclut le fin de null.

[in, out] RequiredSize

S’il n'NULL, pointeur vers une variable qui reçoit la taille requise pour la mémoire tampon pointée par le paramètre ReturnBuffer, en caractères. Ce nombre inclut le fin de null. Si ReturnBuffer est spécifié et que la taille réelle est supérieure à la valeur spécifiée par ReturnBufferSize, la fonction échoue et un appel à GetLastError retourne ERROR_INSUFFICIENT_BUFFER.

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.

Si SetupQueryInfVersionInformation est appelé sur un fichier INF hérité, les informations de version sont générées à partir du fichier INF hérité de la manière suivante :

La clé OptionType dans la section Identification du fichier hérité est retournée en tant que valeur de clé de classe.
La clé FileType dans la section Signature du fichier INF hérité devient la valeur de clé de signature.
Si la valeur de la clé FileType du fichier INF hérité est MICROSOFT_FILE, la valeur de clé du fournisseur est définie sur « Microsoft ».

Le tableau suivant résume la façon dont les informations sont traduites avant qu’elles ne soient passées dans la structure SP_INF_INFORMATION.

Informations sur les fichiers hérités	Informations Windows INF
`[Identification] OptionType = Mouse`	`[Version] Class=Mouse`
`[Signature] FileType = MICROSOFT_FILE`	`Signature=MICROSOFT_FILE`
(si FileType est MICROSOFT_FILE)	`Provider="Microsoft"`

Note

L’en-tête setupapi.h définit SetupQueryInfVersionInformation 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

Voir aussi

Functions

Vue d’ensemble

SetupGetInfInformation

SetupQueryInfFileInformation

Partager via