Méthode Product.InstallProperty

  • Article

La propriété InstallProperty est la valeur de la propriété pour l’instance de ce produit.

Cette propriété appelle la fonction MsiGetProductInfoEx, avec les valeurs ProductCode, UserSid et Context de l’objet Product et la propriété demandée en tant que paramètre.

Syntaxe

Product.InstallProperty(
  property
)

Paramètres

property

Spécifie la propriété à récupérer. Les propriétés de la liste suivante ne peuvent être récupérées qu’à partir d’applications déjà installées. Notez que la disponibilité des propriétés requises est garantie, mais que d’autres propriétés sont disponibles uniquement si cette propriété a été définie. Pour plus d’informations sur la façon dont chaque propriété est définie, consultez les liens indiqués vers les propriétés du programme d’installation.

Propriétés installées Signification
INSTALLPROPERTY_PRODUCTSTATE
 État du produit retourné sous forme de chaîne, par exemple « 1 » pour Publié et « 5 » pour Installé.
INSTALLPROPERTY_HELPLINK
 Lien de support. Pour plus d’informations, consultez la propriété ARPHELPLINK.
INSTALLPROPERTY_HELPTELEPHONE
 Numéro de téléphone du support. Pour plus d’informations, consultez la propriété ARPHELPTELEPHONE.
INSTALLPROPERTY_INSTALLDATE
 Dernière fois que ce produit a fait l’objet d’une maintenance. La valeur de cette propriété est remplacée chaque fois qu’un correctif est appliqué ou supprimé du produit ou que l’option de ligne de commande /v est utilisée pour réparer le produit. Si le produit n’a reçu aucune réparation ni aucun correctif, cette propriété contient l’heure à laquelle il a été installé sur cet ordinateur.
INSTALLPROPERTY_INSTALLEDPRODUCTNAME
 Nom du produit installé. Pour plus d’informations, consultez la propriété ProductName.
INSTALLPROPERTY_INSTALLLOCATION
 Emplacement d’installation. Pour plus d’informations, consultez la propriété ARPINSTALLLOCATION.
INSTALLPROPERTY_INSTALLSOURCE
 Source de l’installation. Pour plus d’informations, consultez la propriété SourceDir.
INSTALLPROPERTY_LOCALPACKAGE
 Package mis en cache local.
INSTALLPROPERTY_PUBLISHER
 Publisher. Pour plus d’informations, consultez la propriété Manufacturer.
INSTALLPROPERTY_URLINFOABOUT
 Informations relatives à l’URL. Pour plus d’informations, consultez la propriété ARPURLINFOABOUT.
INSTALLPROPERTY_URLUPDATEINFO
 Informations de mise à jour d’URL. Pour plus d’informations, consultez la propriété ARPURLUPDATEINFO.
INSTALLPROPERTY_VERSIONMINOR
 Version de produit mineure dérivée de la propriété ProductVersion.
INSTALLPROPERTY_VERSIONMAJOR
 Version de produit majeure dérivée de la propriété ProductVersion.
INSTALLPROPERTY_VERSIONSTRING
 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 déjà installées, définissez le champ property 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 L’entreprise inscrite pour utiliser ce produit.
RegOwner Le propriétaire inscrit pour utiliser ce produit.

 

Pour récupérer le type instance du produit, définissez property sur la valeur suivante. Cette propriété est disponible pour les produits publiés ou installés.

Valeur Description
InstanceType Une valeur manquante ou 0 indique une installation normale du produit. La valeur 1 indique un produit installé à l’aide d’une transformation de plusieurs instances 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 de la liste suivante peuvent également être récupérées à partir d’applications publiées. Ces propriétés ne peuvent pas être récupérées pour les instances de produit installées dans un contexte non managé par utilisateur pour les comptes d’utilisateur autres que celui de l’utilisateur actuel.

Propriétés publiées Description
INSTALLPROPERTY_TRANSFORMS Transformations :
INSTALLPROPERTY_LANGUAGE Langue du produit.
INSTALLPROPERTY_PRODUCTNAME Nom du produit lisible par l’utilisateur. Pour plus d’informations, consultez la propriété ProductName.
INSTALLPROPERTY_ASSIGNMENTTYPE Est égale à zéro (0) si le produit est publié ou installé par utilisateur. Est égale à un (1) 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 1 indique un produit qui peut être mis en service par des utilisateurs non-administrateurs à l’aide de la mise à jour corrective du contrôle de compte d’utilisateur (UAC). Une valeur manquante ou égale à 0 indique que la mise à jour corrective des privilèges minimum n’est pas activée. Disponible avec Windows Installer 3.0 et versions ultérieures.

 

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Si l’appel réussit, la propriété contient la valeur en tant que chaîne.

Configuration requise

Condition requise Valeur
Version
 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 3.0 (ou version ultérieure) sur Windows Server 2003, Windows XP et Windows 2000.
DLL
Msi.dll
IID
 IID_IProduct est défini comme 000C10A0-0000-0000-C000-000000000046.

Voir aussi

Produit

Non pris en charge par Windows Installer 2.0 et antérieur