Obtient les informations texte à partir des informations de version d'une ressource du module binaire spécifiée
#include <WinAPIRes.au3>
_WinAPI_VerQueryValueEx ( $hModule [, $sValues = '' [, $iLanguage = 0x0400]] )
| $hModule | La handle à un module où récupérer les informations. Ce paramètre permet aussi de spécifier le nom du module à charger, il doit être un chemin complet ou relatif. Si ce paramètre est 0 ou une chaîne vide, c'est alors équivalent à passer le handle de module utilisé pour créer le processus en cours. |
| $sValues | [optionnel] La chaîne contenant les noms de champ pour lequel vous souhaitez obtenir des valeurs. Les noms doivent être séparés par '|'. Par exemple,"nom1|nom2|...|nomi". Si certains champs n'existent pas, les éléments correspondants du tableau sont des chaînes vides. Si ce paramètre n'est pas spécifié (chaîne vide), la fonction utilise les noms réservés (12) dans l'ordre suivant: $FV_COMMENTS ("Comments") $FV_COMPANYNAME ("CompanyName") $FV_FILEDESCRIPTION ("FileDescription") $FV_FILEVERSION ("FileVersion") $FV_INTERNALNAME ("InternalName") $FV_LEGALCOPYRIGHT ("LegalCopyright") $FV_LEGALTRADEMARKS ("LegalTrademarks") $FV_ORIGINALFILENAME ("OriginalFilename") $FV_PRODUCTNAME ("ProductName") $FV_PRODUCTVERSION ("ProductVersion") $FV_PRIVATEBUILD ("PrivateBuild") $FV_SPECIALBUILD ("SpecialBuild") Les constantes sont définis dans FileConstants.au3. |
| $iLanguage | [optionnel] L'identifiant de langue de la ressource des informations de version qui vous intéresse. Pour récupérer des informations pour la langue utilisateur par défaut définissez ce paramètre à $LOCALE_USER_DEFAULT (par défaut). Pour récupérer les informations pour toutes les langues qui se trouvent dans la ressource définissez ce paramètre à (-1). |
| Succès: | Retourne le tableau 2D des valeurs de chaîne spécifiées par le paramètre $sValues pour chaque langue. L'élément [0][0] du tableau contient le nombre de langues de la ressource. La dimension du tableau est égale au nombre de paramètres spécifiés + 1. L'élément [n][0] du tableau contient l'identifiant de la langue (ID). [0][0] - Nombre de langues (n) [0][i] - Inutilisé [n][0] - ID [n][i] - Valeur |
| Échec: | Définit @error <> 0. |
L'identifiant (ID) de la ressource d'information de version doit être égale à 1, sinon la fonction échoue.
#include <APILocaleConstants.au3> #include <Array.au3> #include <WinAPILocale.au3> #include <WinAPIRes.au3> Local $aData = _WinAPI_VerQueryValueEx(@ScriptDir & '\Extras\Resources.dll', 'FileDescription|FileVersion|OriginalFilename', -1) If Not @error Then For $i = 1 To $aData[0][0] $aData[$i][0] = _WinAPI_GetLocaleInfo($aData[$i][0], $LOCALE_SLANGUAGE) Next EndIf _ArrayDisplay($aData, '_WinAPI_VerQueryValueEx')