IMsmMerge2::MergeEx-Methode (mergemod.h)
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 |
|---|---|
|
Dem System ging der Arbeitsspeicher nicht mehr aus, und der Vorgang konnte nicht abgeschlossen werden. |
|
Eines der Argumente ist ungültig. |
|
Die Zusammenführung wurde aufgrund eines Fehlers beendet. Einige Tabellen wurden möglicherweise nicht zusammengeführt. Weitere Informationen finden Sie im Abschnitt Hinweise. |
|
Die Funktion war erfolgreich, aber es sind Fehler aufgetreten, und die Zusammenführung selbst ist möglicherweise ungültig. |
|
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 |