MsiGetShortcutTargetA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiGetShortcutTarget--Funktion untersucht eine Verknüpfung und gibt ggf. den Produkt-, Featurenamen und die Komponente zurück.

Syntax

UINT MsiGetShortcutTargetA(
  [in]  LPCSTR szShortcutPath,
  [out] LPSTR  szProductCode,
  [out] LPSTR  szFeatureId,
  [out] LPSTR  szComponentCode
);

Parameter

[in] szShortcutPath

Eine mit Null beendete 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 für das endende Nullzeichen. 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 für das endende Nullzeichen. Dieser Parameter kann null sein.

Rückgabewert

Diese Funktion gibt UINT zurück.

Bemerkungen

Wenn die Funktion fehlschlägt und die Verknüpfung vorhanden ist, kann auf den regulären Inhalt der Verknüpfung über die IShellLink--Schnittstelle zugegriffen werden.

Andernfalls kann der Status des Ziels mithilfe der Installer Selection Functionsbestimmt werden.

Anmerkung

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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte 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 von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll

Freigeben über