MsiGetProductInfoW, fonction (msi.h)
La fonction MsiGetProductInfo retourne les informations de produit pour les produits publiés et installés.
Syntaxe
UINT MsiGetProductInfoW(
[in] LPCWSTR szProduct,
[in] LPCWSTR szAttribute,
[out] LPWSTR lpValueBuf,
[in, out] LPDWORD pcchValueBuf
);
Paramètres
[in] szProduct
Spécifie le code de produit du produit.
[in] szAttribute
Spécifie la propriété à récupérer.
Les Propriétés requises sont garanties d’être disponibles, mais d’autres propriétés sont disponibles uniquement si cette propriété est définie. Pour plus d’informations, consultez Propriétés. Les propriétés de la liste suivante peuvent être récupérées uniquement à partir d’applications installées.
| Propriété | Signification |
|---|---|
|
Lien de support. Pour plus d’informations, consultez la propriété ARPHELPLINK |
|
Téléphone de support. Pour plus d’informations, consultez la propriété ARPHELPTELEPHONE. |
|
La dernière fois que ce produit a reçu le service. La valeur de cette propriété est remplacée chaque fois qu’un correctif est appliqué ou supprimé du produit ou que /v Command-Line Option est utilisé pour réparer le produit. Si le produit n’a reçu aucune réparation ni correctif, cette propriété contient le moment où ce produit a été installé sur cet ordinateur. |
|
Langue installée.
Windows Installer 4.5 et versions antérieures: Non pris en charge. |
|
Nom du produit installé. Pour plus d’informations, consultez la propriété ProductName. |
|
Emplacement d’installation. Pour plus d’informations, consultez la propriété ARPINSTALLLOCATION. |
|
Source d’installation. Pour plus d’informations, consultez la propriété SourceDir. |
|
Package mis en cache local. |
|
Éditeur. Pour plus d’informations, consultez la propriété Manufacturer. |
|
Informations d’URL. Pour plus d’informations, consultez la propriété ARPURLINFOABOUT |
|
Informations de mise à jour d’URL. Pour plus d’informations, consultez la propriété ARPURLUPDATEINFO. |
|
Version mineure du produit dérivé de la propriété ProductVersion |
|
Version principale du produit dérivée de la propriété ProductVersion |
|
Version du produit. Pour plus d’informations, consultez la propriété ProductVersion. |
Pour récupérer l’ID de produit, le propriétaire inscrit ou l’entreprise inscrite à partir d’applications installées, définissez szProperty sur l’une des valeurs de chaîne de texte suivantes.
| Valeur | Description |
|---|---|
| Productid | Identificateur du produit. Pour plus d’informations, consultez la propriété ProductID. |
| RegCompany | Société inscrite pour utiliser ce produit. |
| RegOwner | Propriétaire inscrit pour utiliser ce produit. |
Pour récupérer le type d’instance du produit, définissez szProperty sur la valeur suivante. Cette propriété est disponible pour les produits publiés ou installés.
| Valeur | Description |
|---|---|
| InstanceType | Une valeur manquante ou une valeur de 0 (zéro) indique une installation normale du produit. La valeur 1 (un) indique qu’un produit est installé à l’aide d’une transformation d’instance multiple et de la propriété MSINEWINSTANCE. Disponible avec le programme d’installation exécutant Windows Server 2003 ou Windows XP avec SP1. Pour plus d’informations, consultez Installation de plusieurs instances de produits et de correctifs. |
Les propriétés publiées dans la liste suivante peuvent être récupérées à partir d’applications publiées ou installées.
| Propriété | Description |
|---|---|
| INSTALLPROPERTY_TRANSFORMS | Transforme. |
| INSTALLPROPERTY_LANGUAGE | Langue du produit. |
| INSTALLPROPERTY_PRODUCTNAME | Nom du produit lisible par l’homme. Pour plus d’informations, consultez la propriété ProductName. |
| INSTALLPROPERTY_ASSIGNMENTTYPE | Est égal à 0 (zéro) si le produit est publié ou installé par utilisateur.
Est égal à 1 (un) si le produit est publié ou installé par ordinateur pour tous les utilisateurs. |
| INSTALLPROPERTY_PACKAGECODE | Identificateur du package à partir duquel ce produit a été installé. Pour plus d’informations, consultez Codes de package. |
| INSTALLPROPERTY_VERSION | Version de produit dérivée de la propriété ProductVersion |
| INSTALLPROPERTY_PRODUCTICON | Icône principale du package. Pour plus d’informations, consultez la propriété ARPPRODUCTICON |
| INSTALLPROPERTY_PACKAGENAME | Nom du package d’installation d’origine. |
| INSTALLPROPERTY_AUTHORIZED_LUA_APP | La valeur d’un (1) indique un produit qui peut être utilisé par des non-administrateurs à l’aide d'de mise à jour corrective du contrôle de compte d’utilisateur (UAC). Une valeur manquante ou une valeur de 0 (zéro) indique que la mise à jour corrective avec privilèges minimum n’est pas activée. Disponible dans Windows Installer 3.0 ou version ultérieure. |
[out] lpValueBuf
Pointeur vers une mémoire tampon qui reçoit la valeur de la propriété. Ce paramètre peut être null.
[in, out] pcchValueBuf
Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon pointée par le paramètre lpValueBuf. 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.
Si lpValueBuf a la valeur Null, pcchValueBuf peut être null. Dans ce cas, la fonction vérifie que la propriété est correctement inscrite auprès du produit.
Valeur de retour
| Valeur | Signification |
|---|---|
|
Les données de configuration sont endommagées. |
|
Un paramètre non valide a été passé à la fonction. |
|
Une mémoire tampon est trop petite pour contenir les données demandées. |
|
La fonction s’est terminée correctement. |
|
Le produit n’est pas déconseillé ou désinstallé. |
|
La propriété n’est pas reconnue.
Remarque La fonction MsiGetProductInfo retourne ERROR_UNKNOWN_PROPERTY si l’application interrogée est annoncée et non installée.
|
Remarques
Lorsque la fonction MsiGetProductInfo retourne, le paramètre pcchValueBuf contient la longueur de la chaîne stockée dans la mémoire tampon. Le nombre retourné n’inclut pas le caractère null de fin. Si la mémoire tampon n’est pas suffisamment grande, MsiGetProductInfo retourne ERROR_MORE_DATA et pcchValueBuf contient la taille de la chaîne, en caractères, sans compter le caractère null.
msiGetProductInfo(INSTALLPROPERTY_LOCALPACKAGE) ne retourne pas nécessairement un chemin d’accès au package mis en cache. Le package mis en cache est destiné uniquement à une utilisation interne. Les installations en mode maintenance doivent être appelées via les fonctions MsiConfigureFeature, MsiConfigureProductou fonctions MsiConfigureProductEx.
Si vous tentez d’utiliser MsiGetProductInfo pour interroger un produit publié pour une propriété disponible uniquement pour les produits installés, la fonction retourne ERROR_UNKNOWN_PROPERTY. Par exemple, si l’application est annoncée et non installée, une requête pour la propriété INSTALLPROPERTY_INSTALLLOCATION retourne une erreur de ERROR_UNKNOWN_PROPERTY.
Note
L’en-tête msi.h définit MsiGetProductInfo 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
détermination du contexte d’installation
non pris en charge dans Windows Installer 2.0 et versions antérieures