MsiGetShortcutTargetA-Funktion (msi.h)

  • Artikel

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