IMsmMerge::Merge-Methode (mergemod.h)

Die Methode Merge führt eine Zusammenführung der aktuellen Datenbank und des aktuellen Moduls aus. Die Zusammenführung fügt die Komponenten im Modul an das durch Feature identifizierte Feature an. Der Stamm der Verzeichnisstruktur des Moduls wird an den von RedirectDir angegebenen Speicherort umgeleitet. Weitere Informationen finden Sie unter der Merge-Methode des Merge-Objekts .

IMsmMerge2::Merge Mergemod.dll Version 2.0 oder höher.

 

IMsmMerge::Merge Alle Mergemod.dll Versionen.

Syntax

HRESULT Merge(
  [in] const BSTR Feature,
  [in] const BSTR RedirectDir
);

Parameter

[in] Feature

Der Name eines Features in der Datenbank. Anstelle eines BSTR kann ein LPCWSTR verwendet werden.

[in] RedirectDir

Der Schlüssel eines Eintrags in der Verzeichnistabelle der Datenbank. Anstelle eines BSTR kann ein LPCWSTR verwendet werden. Dieser Parameter kann NULL oder eine leere Zeichenfolge sein.

Rückgabewert

Die Merge-Funktion gibt die folgenden Werte zurück.

Wert	Bedeutung
E_FAIL	Bei der Zusammenführung ist ein schwerwiegender Fehler aufgetreten. Dies weist auf einen Betriebsfehler hin und ist nicht die normale Fehlerrückgabe für eine fehlgeschlagene Zusammenführung.
S_FALSE	Die Funktion war erfolgreich, aber es sind Fehler aufgetreten, und die Zusammenführung selbst ist möglicherweise ungültig.
E_INVALIDARG	Eines der Argumente ist ungültig.
E_OUTOFMEMORY	Dem System ging der Arbeitsspeicher nicht mehr aus, und der Vorgang konnte nicht abgeschlossen werden.
S_OK	Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Diese Funktion führt eine Zusammenführung der aktuellen Datenbank und des aktuellen Moduls aus. Der Stamm der Verzeichnisstruktur des Moduls wird an den von RedirectDir angegebenen Speicherort umgeleitet. 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 mithilfe der funktion get_Errors abgerufen werden. Fehler und Informationsmeldungen werden in der aktuellen Protokolldatei bereitgestellt.

Beachten Sie, dass die Merge-Funktion alle Funktionsverweise im Modul abruft und den Featureverweis durch alle Vorkommen der NULL-GUID in der Moduldatenbank ersetzt. Weitere Informationen finden Sie unter Verweisen auf Features in Mergemodulen.

Nach Abschluss der Zusammenführung werden die Komponenten im Modul an das Feature angefügt, das durch Feature identifiziert wird. Dieses Feature muss bereits vorhanden sein und wird nicht erstellt.

Das Modul kann mithilfe der Connect-Funktion an zusätzliche Features angefügt werden. Beachten Sie, dass durch das Aufrufen der Connect-Funktion nur Feature-Komponentenzuordnungen erstellt werden. Die Zeilen, die bereits in der Datenbank zusammengeführt wurden, werden dabei nicht geändert.

An der Datenbank vorgenommene Änderungen werden nicht auf dem Datenträger gespeichert, es sei denn, die CloseDatabase-Funktion wird aufgerufen, wobei bCommit auf TRUE festgelegt ist.

Anforderungen

Unterstützte Mindestversion (Client)	Mergemod.dll 1.0 oder höher
Zielplattform	Windows
Kopfzeile	mergemod.h
DLL	Mergemod.dll

Weitere Informationen

Automatisierung für Mergemodule