MsiGetFeatureStateW, fonction (msiquery.h)

Article
08/25/2023

La fonction MsiGetFeatureState obtient l’état demandé d’une fonctionnalité.

Syntaxe

UINT MsiGetFeatureStateW(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCWSTR      szFeature,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

Paramètres

[in] hInstall

Gérez l’installation fournie à une action personnalisée DLL ou obtenue via MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] szFeature

Spécifie le nom de la fonctionnalité dans le produit.

[out] piInstalled

Spécifie l’état installé actuel retourné. Ce paramètre ne doit pas être null. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
INSTALLSTATE_BADCONFIG	Les données de configuration sont endommagées.
INSTALLSTATE_INCOMPLETE	L’installation est suspendue ou en cours.
INSTALLSTATE_SOURCEABSENT	La fonctionnalité doit s’exécuter à partir de la source et la source n’est pas disponible.
INSTALLSTATE_MOREDATA	La mémoire tampon de retour est pleine.
INSTALLSTATE_INVALIDARG	Un paramètre non valide a été transmis à la fonction.
INSTALLSTATE_UNKNOWN	Un produit ou une fonctionnalité non reconnu a été spécifié.
INSTALLSTATE_BROKEN	La fonctionnalité est interrompue.
INSTALLSTATE_ADVERTISED	Fonctionnalité annoncée.
INSTALLSTATE_ABSENT	La fonctionnalité a été désinstallée.
INSTALLSTATE_LOCAL	La fonctionnalité a été installée sur le lecteur local.
INSTALLSTATE_SOURCE	La fonctionnalité doit s’exécuter à partir de la source, du CD-ROM ou du réseau.
INSTALLSTATE_DEFAULT	La fonctionnalité est installée à l’emplacement par défaut : local ou source.

[out] piAction

Reçoit l’action effectuée pendant la session d’installation. Ce paramètre ne doit pas être null. Pour connaître les valeurs de retour, consultez piInstalled.

Valeur retournée

La fonction MsiGetFeatureState retourne les valeurs suivantes :

Remarques

Consultez Appel de fonctions de base de données à partir de programmes.

Si la fonction échoue, vous pouvez obtenir des informations d’erreur étendues à l’aide de MsiGetLastErrorRecord.

Notes

L’en-tête msiquery.h définit MsiGetFeatureState comme un 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.

Configuration requise

Condition requise	Valeur
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
Plateforme cible	Windows
En-tête	msiquery.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions de sélection du programme d’installation

Passage de la valeur Null en tant qu’argument des fonctions Windows Installer

Partager via