MsiGetShortcutTargetA, fonction (msi.h)

La fonction MsiGetShortcutTarget examine un raccourci et retourne son produit, son nom de fonctionnalité et son composant, le cas échéant.

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 de produit du raccourci. Cette mémoire tampon de chaîne doit comporter 39 caractères. Les 38 premiers caractères sont pour le GUID, et le dernier caractère est pour le caractère null de fin. Ce paramètre peut avoir la valeur Null.

[out] szFeatureId

Nom de la fonctionnalité du raccourci. La mémoire tampon de chaîne doit comporter MAX_FEATURE_CHARS+1 caractères. Ce paramètre peut avoir la valeur Null.

[out] szComponentCode

GUID du code du composant. Cette mémoire tampon de chaîne doit comporter 39 caractères. Les 38 premiers caractères sont pour le GUID, et le dernier caractère est pour le caractère null de fin. Ce paramètre peut avoir la valeur Null.

Valeur retournée

Cette fonction retourne UINT.

Notes

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.

Notes

L’en-tête msi.h définit MsiGetShortcutTarget 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.

Spécifications

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