UDF > WinAPIEx > Menus & Resources > Resources >

_WinAPI_VerQueryValue

Obtient les informations variables (chaînes) sur la version d'une ressource à parir des informations de version spécifiées

#include <WinAPIRes.au3>
_WinAPI_VerQueryValue ( $pData [, $sValues = ''] )

Paramètres

$pData

Le pointeur sur la mémoire tampon qui contient les informations de version de la ressource retourné par le paramètre $pBuffer de la foncion _WinAPI_GetFileVersionInfo().

$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 coorespondants du tableau sont des chaînes vides.
Si ce paramètre n'est pas spécifié (chaîne vide), la fonction utilise les noms (12) réservés 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éfinies dans FileConstants.au3.

Valeur de retour

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.

Voir aussi

Consultez VerQueryValue dans la librairie MSDN.

Exemple

#include <Array.au3>
#include <WinAPIMem.au3>
#include <WinAPIRes.au3>

Local $pData = 0
If Not _WinAPI_GetFileVersionInfo(@SystemDir & '\shell32.dll', $pData) Then
    Exit
EndIf

Local $aData = _WinAPI_VerQueryValue($pData)

_ArrayDisplay($aData, '_WinAPI_VerQueryValue')

_WinAPI_FreeMemory($pData)