MsiSetTargetPathA-Funktion (msiquery.h)

  • Artikel

Die MsiSetTargetPath-Funktion legt den vollständigen Zielpfad für einen Ordner in der Verzeichnistabelle fest.

Syntax

UINT MsiSetTargetPathA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFolder,
  [in] LPCSTR    szFolderPath
);

Parameter

[in] hInstall

Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

[in] szFolder

Gibt den Ordnerbezeichner an. Dies ist ein Primärschlüssel in der Verzeichnistabelle.

[in] szFolderPath

Gibt den vollständigen Pfad für den Ordner an, der in einem Verzeichnistrennzeichen endet.

Rückgabewert

Die MsiSetTargetPath-Funktion gibt die folgenden Werte zurück:

Hinweise

Die MsiSetTargetPath-Funktion ändert die Pfadspezifikation für das Zielverzeichnis mit dem Namen in der Verzeichnistabelle im Arbeitsspeicher. Außerdem werden die Pfadspezifikationen aller anderen Pfadobjekte in der Tabelle, die dem geänderten Pfad entweder untergeordneten oder gleichwertigen sind, aktualisiert, um die Änderung widerzuspiegeln. Die Eigenschaften für jeden betroffenen Pfad werden ebenfalls aktualisiert.

MsiSetTargetPath schlägt fehl, wenn das ausgewählte Verzeichnis schreibgeschützter Ist.

Wenn in dieser Funktion ein Fehler auftritt, rückgängig machen alle aktualisierten Pfade und Eigenschaften zu ihren vorherigen Werten. Daher ist es sicher, fehler, die von dieser Funktion zurückgegeben werden, als nicht schwerwiegende Fehler zu behandeln.

Versuchen Sie nicht, den Zielpfad zu konfigurieren, wenn die Komponenten, die diese Pfade verwenden, bereits für den aktuellen Benutzer oder für einen anderen Benutzer installiert sind. Überprüfen Sie die ProductState-Eigenschaft , bevor Sie MsiSetTargetPath aufrufen, um festzustellen, ob das Produkt, das diese Komponente enthält, installiert ist.

Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.

Hinweis

Der msiquery.h-Header definiert MsiSetTargetPath 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
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
Zielplattform Windows
Kopfzeile msiquery.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Installerspeicherortfunktionen