MsiGetShortcutTargetA, fonction (msi.h)
La fonction MsiGetShortcutTarget examine un raccourci et retourne son produit, son nom de fonctionnalité et son composant s’il est disponible.
Syntaxe
UINT MsiGetShortcutTargetA(
[in] LPCSTR szShortcutPath,
[out] LPSTR szProductCode,
[out] LPSTR szFeatureId,
[out] LPSTR szComponentCode
);
Paramètres
[in] szShortcutPath
Chaîne terminée par null spécifiant le chemin d’accès complet à un raccourci.
[out] szProductCode
GUID pour le code produit du raccourci. Cette mémoire tampon de chaîne doit contenir 39 caractères. Les 38 premiers caractères concernent le GUID , et le dernier caractère correspond au caractère null de fin. Ce paramètre peut être null.
[out] szFeatureId
Nom de la fonctionnalité du raccourci. La mémoire tampon de chaîne doit être MAX_FEATURE_CHARS+1 caractères longs. Ce paramètre peut être null.
[out] szComponentCode
GUID du code du composant. Cette mémoire tampon de chaîne doit contenir 39 caractères. Les 38 premiers caractères concernent le GUID , et le dernier caractère correspond au caractère null de fin. Ce paramètre peut être null.
Valeur de retour
Cette fonction retourne UINT.
Remarques
Si la fonction échoue et que le raccourci existe, le contenu normal du raccourci est accessible via l’interface IShellLink.
Sinon, l’état de la cible peut être déterminé à l’aide des fonctions de sélection du programme d’installation .
Note
L’en-tête msi.h définit MsiGetShortcutTarget 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer. |
plateforme cible | Windows |
d’en-tête | msi.h |
bibliothèque | Msi.lib |
DLL | Msi.dll |