IMsmMerge2::MergeEx-Methode (mergemod.h)

Artikel
08/24/2023

Die MergeEx-Methode 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 MergeEx-Methode des Merge-Objekts .

Syntax

HRESULT MergeEx(
  [in] const BSTR Feature,
  [in] const BSTR RedirectDir,
  [in] IUnknown   *pConfiguration
);

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.

[in] pConfiguration

Das Argument pConfiguration ist eine vom Client implementierte Schnittstelle. Das Argument kann NULL sein. Das Vorhandensein dieses Arguments gibt an, dass das Clienttool konfigurierbare Mergemodule ändern kann. Das Vorhandensein dieses Arguments erfordert nicht, dass der Client Konfigurationsdaten für ein bestimmtes konfigurierbares Element bereitstellt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
E_OUTOFMEMORY	Dem System ging der Arbeitsspeicher nicht mehr aus, und der Vorgang konnte nicht abgeschlossen werden.
E_INVALIDARG	Eines der Argumente ist ungültig.
E_FAIL	Die Zusammenführung wurde aufgrund eines Fehlers beendet. Einige Tabellen wurden möglicherweise nicht zusammengeführt. Weitere Informationen finden Sie im Abschnitt Hinweise.
S_FALSE	Die Funktion war erfolgreich, aber es sind Fehler aufgetreten, und die Zusammenführung selbst ist möglicherweise ungültig.
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 get_Errors-Funktion abgerufen werden. Fehler und Informationsmeldungen werden in der aktuellen Protokolldatei bereitgestellt.

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.

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.

Wenn die Zusammenführung aufgrund einer falschen Modulkonfiguration fehlschlägt, gibt die Funktion 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.

Anforderungen


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

Weitere Informationen

Automatisierung für Mergemodule

Share via