MsiSetComponentStateA, fonction (msiquery.h)

Article
11/20/2024

La fonction MsiSetComponentState définit un composant à l’état demandé.

Syntaxe

UINT MsiSetComponentStateA(
  [in] MSIHANDLE    hInstall,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE iState
);

Paramètres

[in] hInstall

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

[in] szComponent

Spécifie le nom du composant.

[in] iState

Spécifie l’état à définir. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
INSTALLSTATE_ABSENT	Le composant a été désinstallé.
INSTALLSTATE_LOCAL	Le composant a été installé sur le lecteur local.
INSTALLSTATE_SOURCE	Le composant s’exécute à partir de la source, du CD ou du réseau.

Valeur de retour

La fonction MsiSetComponentState retourne les valeurs suivantes :

Remarques

La fonction MsiSetComponentState demande une modification de l’état Action d’un enregistrement dans la table composant .

Pour plus d’informations, 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.

Note

L’en-tête msiquery.h définit MsiSetComponentState 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
plateforme cible	Windows
d’en-tête	msiquery.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions de sélection du programme d’installation

Partager via