MsiGetShortcutTargetA-Funktion (msi.h)
Die MsiGetShortcutTarget-Funktion untersucht eine Verknüpfung und gibt ihr Produkt, den Featurenamen und die Komponente zurück, sofern verfügbar.
Syntax
UINT MsiGetShortcutTargetA(
[in] LPCSTR szShortcutPath,
[out] LPSTR szProductCode,
[out] LPSTR szFeatureId,
[out] LPSTR szComponentCode
);
Parameter
[in] szShortcutPath
Eine NULL-Zeichenfolge, die den vollständigen Pfad zu einer Verknüpfung angibt.
[out] szProductCode
Eine GUID für den Produktcode der Verknüpfung. Dieser Zeichenfolgenpuffer muss 39 Zeichen lang sein. Die ersten 38 Zeichen sind für die GUID, und das letzte Zeichen ist für das beendende NULL-Zeichen. Dieser Parameter kann NULL sein.
[out] szFeatureId
Der Featurename der Verknüpfung. Der Zeichenfolgenpuffer muss MAX_FEATURE_CHARS+1 Zeichen lang sein. Dieser Parameter kann NULL sein.
[out] szComponentCode
Eine GUID des Komponentencodes. Dieser Zeichenfolgenpuffer muss 39 Zeichen lang sein. Die ersten 38 Zeichen sind für die GUID, und das letzte Zeichen ist für das beendende NULL-Zeichen. Dieser Parameter kann NULL sein.
Rückgabewert
Diese Funktion gibt UINT zurück.
Hinweise
Wenn die Funktion fehlschlägt und die Verknüpfung vorhanden ist, kann über die IShellLink-Schnittstelle auf den regulären Inhalt der Verknüpfung zugegriffen werden.
Andernfalls kann der Status des Ziels mithilfe der Installerauswahlfunktionen bestimmt werden.
Hinweis
Der msi.h-Header definiert MsiGetShortcutTarget als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen. |
Zielplattform | Windows |
Kopfzeile | msi.h |
Bibliothek | Msi.lib |
DLL | Msi.dll |