Methode Merge.MergeEx

Die Methode MergeEx des Merge-Objekts entspricht der Merge-Funktion, mit der Ausnahme, dass sie ein zusätzliches Argument verwendet. Das Argument pConfiguration ist eine vom Client implementierte Schnittstelle. Das Argument kann NULL sein. Das Vorhandensein dieses Arguments gibt an, dass der Client die Konfigurationsfunktionalität unterstützen kann, aber nicht verpflichtet, Konfigurationsdaten für ein bestimmtes konfigurierbares Element bereitzustellen.

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.

Syntax

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

Parameter

Feature

Der Name eines Features in der Datenbank.

RedirectDir

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

pConfiguration

Das Argument pConfiguration ist eine vom Client implementierte Schnittstelle. Das Argument kann NULL sein. Das Vorhandensein dieses Arguments gibt an, dass der Client die Konfigurationsfunktionalität unterstützen kann, aber nicht verpflichtet, Konfigurationsdaten für ein bestimmtes konfigurierbares Element bereitzustellen.

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. Dieses Feature wird nicht erstellt und muss ein vorhandenes Feature sein. Das Modul kann mithilfe der Methode Connect an zusätzliche Features angefügt werden.

Ä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 bereitgestellt.

Wenn die Zusammenführung aufgrund einer falschen Modulkonfiguration fehlschlägt, gibt die Funktion MergeEx E_FAIL zurück. Dies schließt die folgenden msmErrorType-Fehler ein: msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItem und msmErrorDataRequestFailed. Diese Fehler führen dazu, dass die Zusammenführung sofort beendet wird, wenn der Fehler auftritt. Das Fehlerobjekt wird dem Enumerator weiterhin hinzugefügt, wenn MergeEx E_FAIL zurückgibt. Weitere Informationen zu msmErrorType-Fehlern finden Sie unter get_Type Function (Error Object). Alle anderen Fehler führen dazu, dass MergeEx S_FALSE zurückgibt und die Zusammenführung fortgesetzt wird.

C++

Siehe Funktion MergeEx.

Anforderungen

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