MsiGetFileVersionA, fonction (msi.h)

  • Article

MsiGetFileVersion retourne la chaîne de version et la chaîne de langue au format que le programme d’installation s’attend à trouver dans la base de données. Si vous souhaitez uniquement des informations de version, définissez lpLangBuf et pcchLangBuf sur 0 (zéro). Si vous souhaitez simplement obtenir des informations de langue, définissez lpVersionBuf et pcchVersionBuf sur 0 (zéro).

Syntaxe

UINT MsiGetFileVersionA(
  [in]      LPCSTR  szFilePath,
  [out]     LPSTR   lpVersionBuf,
  [in, out] LPDWORD pcchVersionBuf,
  [out]     LPSTR   lpLangBuf,
  [in, out] LPDWORD pcchLangBuf
);

Paramètres

[in] szFilePath

Spécifie le chemin d’accès au fichier.

[out] lpVersionBuf

Retourne la version du fichier.

Définissez sur 0 pour les informations de langue uniquement.

[in, out] pcchVersionBuf

Nombre de mémoires tampons entrantes et sortantes comme nombre de TCHAR.

Définissez sur 0 (zéro) pour les informations de langue uniquement. Lors de l’entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.

[out] lpLangBuf

Retourne la langue du fichier.

Définissez sur 0 (zéro) pour les informations de version uniquement.

[in, out] pcchLangBuf

Nombre de mémoires tampons entrantes et sortantes comme nombre de TCHAR.

Définissez sur 0 (zéro) pour les informations de version uniquement. Lors de l’entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.

Valeur retournée

Valeur Signification
ERROR_SUCCESS
 Opération terminée correctement.
ERROR_FILE_NOT_FOUND
 Le fichier n'existe pas.
ERROR_ACCESS_DENIED
 Impossible d’ouvrir le fichier pour obtenir des informations de version.
ERROR_FILE_INVALID
 Le fichier ne contient pas d’informations de version.
ERROR_INVALID_DATA
 Les informations de version ne sont pas valides.
E_FAIL
 Erreur inattendue.

Notes

Notes

L’en-tête msi.h définit MsiGetFileVersion 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. La combinaison 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.

Spécifications

   
Client minimal pris en charge Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible Windows
En-tête msi.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions d’état du système