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.
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 |
|---|---|
|
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. |
|
Die Funktion war erfolgreich, aber es sind Fehler aufgetreten, und die Zusammenführung selbst ist möglicherweise ungültig. |
|
Eines der Argumente ist ungültig. |
|
Dem System ging der Arbeitsspeicher nicht mehr aus, und der Vorgang konnte nicht abgeschlossen werden. |
|
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 |