MsiSequenceA-Funktion (msiquery.h)

  • Artikel

Die MsiSequence-Funktion führt eine weitere Aktionssequenz aus, wie in der angegebenen Tabelle beschrieben.

Syntax

UINT MsiSequenceA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szTable,
  [in] INT       iSequenceMode
);

Parameter

[in] hInstall

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

[in] szTable

Gibt den Namen der Tabelle an, die die Aktionssequenz enthält.

[in] iSequenceMode

Dieser Parameter ist derzeit nicht implementiert. Sie ist für die zukünftige Verwendung reserviert und muss 0 sein.

Rückgabewert

Diese Funktion gibt UINT zurück.

Hinweise

Die MsiSequence-Funktion fragt die angegebene Tabelle ab und sortiert die Aktionen nach den Zahlen in der Sequenzspalte. Für jede abgerufene Zeile wird eine Aktion ausgeführt, sofern kein angegebener Bedingungsausdruck als FALSE ausgewertet wird.

Eine Aktionssequenz, die alle Aktionen enthält, die das System aktualisieren, z. B. die Aktionen InstallFiles und WriteRegistryValues , kann nicht durch Aufrufen von MsiSequence ausgeführt werden. Die Ausnahme von dieser Regel ist, wenn MsiSequence von einer benutzerdefinierten Aktion aufgerufen wird, die in der Tabelle InstallExecuteSequence zwischen den Aktionen InstallInitialize und InstallFinalize geplant ist. Aktionen, mit denen das System nicht aktualisiert wird, z. B. AppSearch oder CostInitialize, können aufgerufen werden.

Hinweis

Der msiquery.h-Header definiert MsiSequence 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

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

Installationsaktionsfunktionen