MsiGetFileVersionW, fonction (msi.h)

Article
11/20/2024

Le 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 voulez simplement des informations de langue, définissez lpVersionBuf et pcchVersionBuf sur 0 (zéro).

Syntaxe

UINT MsiGetFileVersionW(
  [in]      LPCWSTR szFilePath,
  [out]     LPWSTR  lpVersionBuf,
  [in, out] LPDWORD pcchVersionBuf,
  [out]     LPWSTR  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éfini sur 0 pour les informations linguistiques uniquement.

[in, out] pcchVersionBuf

Nombre de mémoires tampons entrantes et sortantes en tant que nombre de TCHAR.

Défini sur 0 (zéro) pour les informations linguistiques 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éfini sur 0 (zéro) pour les informations de version uniquement.

[in, out] pcchLangBuf

Nombre de mémoires tampons entrantes et sortantes en tant que nombre de TCHAR.

Défini 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 de retour

Valeur	Signification
ERROR_SUCCESS	Réussite.
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.

Remarques

Note

L’en-tête msi.h définit MsiGetFileVersion 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 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible	Windows
d’en-tête	msi.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

fonctions d’état système

Partager via