Methode Merge.Merge

Die Merge-Methode des Merge-Objekts nimmt eine Zusammenführung der aktuellen Datenbank und des aktuellen Moduls vor. Die Zusammenführung fügt die Komponenten im Modul zu der Funktion hinzu, die durch Feature identifiziert wird. Der Stamm der Verzeichnisstruktur des Moduls wird an den Speicherort umgeleitet, der durch RedirectDir angegeben wird.

Die Merge-Methode kann nur einmal aufgerufen werden, um eine bestimmte Kombination von MSI- und MSM-Dateien zusammenzuführen.

Syntax

Merge.Merge(
  Feature,
  RedirectDir
)

Parameter

Feature

Der Name eines Features in der Datenbank.

RedirectDir

Der Schlüssel eines Eintrags in der Verzeichnistabelle der Datenbank. Dieser Parameter kann Null oder eine leere Zeichenfolge sein.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Nach Abschluss der Zusammenführung werden die Komponenten im Modul an das Feature angefügt, das durch Feature identifiziert wird. Diese Funktion wird nicht erstellt und muss eine vorhandene Funktion sein. Hinweis: Die Merge-Methode erhält alle Funktionsverweise im Modul und ersetzt die Funktionsverweise für alle Null-GUIDs in der Moduldatenbank. Weitere Informationen finden Sie unter Verweisen auf Features in Mergemodulen.

Das Modul kann mit der Connect-Methode an zusätzliche Funktionen angefügt werden. Beachten Sie, dass der Aufruf der Connect-Methode nur Verknüpfungen zwischen Funktionen und Komponenten erstellt. Die Zeilen, die bereits in der Datenbank zusammengeführt wurden, werden dabei nicht geändert.

Änderungen an der Datenbank werden nur gespeichert, wenn die Methode CloseDatabase aufgerufen wird, wobei bCommit auf TRUE festgelegt ist.

Wenn Zusammenführungskonflikte auftreten, einschließlich Ausschlüssen, werden sie für den späteren Abruf in den Fehlerenumerator eingefügt, führen jedoch nicht dazu, dass die Zusammenführung fehlschlägt. Fehler können über die Eigenschaft Errors abgerufen werden. Fehler- und Informationsmeldungen werden in der aktuellen Protokolldatei aufgeführt.

C++

Siehe „Merge-Funktion“.

Anforderungen

Anforderung Wert
Version
Mergemod.dll 1.0 oder höher
Header
Mergemod.h
DLL
Mergemod.dll