MsiLocateComponentA, fonction (msi.h)
La fonction MsiLocateComponent retourne le chemin d’accès complet à un composant installé sans code de produit. Cette fonction tente de déterminer le produit à l’aide de MsiGetProductCode, mais il n’est pas garanti de trouver le produit approprié pour l’appelant. MsiGetComponentPath doit toujours être appelé lorsque cela est possible.
Syntaxe
INSTALLSTATE MsiLocateComponentA(
[in] LPCSTR szComponent,
[out] LPSTR lpPathBuf,
[in, out] LPDWORD pcchBuf
);
Paramètres
[in] szComponent
Spécifie l’ID du composant à trouver.
[out] lpPathBuf
Pointeur vers une variable qui reçoit le chemin d’accès au composant. La variable inclut le caractère null de fin.
[in, out] pcchBuf
Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpPathBuf . 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. En cas de réussite de la fonction MsiLocateComponent , la variable pointée par pcchBuf contient le nombre de caractères non compris le caractère null de fin. Si la taille de la mémoire tampon passée est trop petite, la fonction retourne INSTALLSTATE_MOREDATA.
Si lpPathBuf a la valeur null, pcchBuf peut être null.
Valeur retournée
Valeur | Signification |
---|---|
|
Le composant demandé est désactivé sur l’ordinateur. |
|
Le composant n’est pas installé. Consultez la section Notes. |
|
L’un des paramètres de fonction n’est pas valide. |
|
Le composant est installé localement. |
|
La mémoire tampon fournie était trop petite. |
|
Le composant est installé pour s’exécuter à partir de la source. |
|
La source du composant est inaccessible. |
|
Le code de produit ou l’ID de composant est inconnu. Consultez la section Notes. |
Remarques
La fonction MsiLocateComponent peut retourner INSTALLSTATE_ABSENT ou INSTALL_STATE_UNKNOWN, pour les raisons suivantes :
- INSTALLSTATE_ABSENT
L’application n’a pas correctement vérifié que la fonctionnalité était installée en appelant MsiUseFeature et, si nécessaire, MsiConfigureFeature.
- INSTALLSTATE_UNKNOWN
La fonctionnalité n’est pas publiée. L’application doit avoir déterminé cela précédemment en appelant MsiQueryFeatureState ou MsiEnumFeatures. L’application effectue ces appels pendant son initialisation. Une application doit uniquement utiliser des fonctionnalités connues pour être publiées. Étant donné que INSTALLSTATE_UNKNOWN devait également avoir été retourné par MsiUseFeature , MsiUseFeature n’a pas été appelé ou sa valeur de retour n’a pas été correctement vérifiée.
Notes
L’en-tête msi.h définit MsiLocateComponent 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. 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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows. |
Plateforme cible | Windows |
En-tête | msi.h |
Bibliothèque | Msi.lib |
DLL | Msi.dll |