Partager via


Fonction SetupQueryInfVersionInformationA (setupapi.h)

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

La fonction SetupQueryInfVersionInformation retourne les informations de version du fichier INF d’une structure SP_INF_INFORMATION à 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 à partir d’un appel à la fonction SetupGetInfInformation .

[in] InfIndex

Index du fichier INF constitutif à partir duquel récupérer les informations de version. Cet index peut se trouver dans la plage [0, InfInformation.InfCount). Ce qui signifie que les valeurs de zéro par InfInformation.InfCount sont valides.

[in] Key

Pointeur facultatif vers une chaîne terminée par null contenant le nom de clé dont la chaîne associée doit être récupérée. Si ce paramètre a la valeur NULL, toutes les clés de ressource sont copiées dans la mémoire tampon fournie. Chaque chaîne est terminée par une valeur null, avec une valeur 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 appel dans laquelle cette fonction retourne le style de fichier INF. Vous devez utiliser une chaîne terminée par null. La chaîne terminée par null 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. À l’aide de cette technique, vous pouvez éviter les erreurs dues à une taille de mémoire tampon insuffisante. Consultez la section Notes. Ce paramètre peut être NULL.

[in] ReturnBufferSize

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

[in, out] RequiredSize

Si ce n’est pas NULL, pointez 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 la fin 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 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

Si cette fonction est appelée avec un ReturnBuffernull 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 cette opération, 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 :

  1. La clé OptionType de la section Identification du fichier hérité est retournée en tant que valeur de clé de classe.
  2. La clé FileType dans la section Signature du fichier INF hérité devient la valeur de clé de signature.
  3. Si la valeur de la clé FileType du fichier INF hérité est MICROSOFT_FILE, la valeur de clé de fournisseur est définie sur « Microsoft ».
Le tableau suivant récapitule la façon dont les informations sont traduites avant d’être transmises à 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"
 

Notes

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

Configuration requise

   
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

Voir aussi

Fonctions

Présentation

SetupGetInfInformation

SetupQueryInfFileInformation