MsiSetComponentStateA, fonction (msiquery.h)
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, MsiOpenPackageEx ou MsiOpenProduct.
[in] szComponent
Spécifie le nom du composant.
[in] iState
Spécifie l’état à définir. Ce paramètre peut prendre les valeurs suivantes.
Valeur retournée
La fonction MsiSetComponentState retourne les valeurs suivantes :
Remarques
La fonction MsiSetComponentState demande une modification de l’état Action d’un enregistrement dans la table Component.
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.
Notes
L’en-tête msiquery.h définit MsiSetComponentState en tant qu’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. La combinaison 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 |