Méthode Merge.MergeEx

La méthode MergeEx de l’objet Merge est équivalente à la fonction Merge , sauf qu’elle prend un argument supplémentaire. L’argument pConfiguration est une interface implémentée par le client. L’argument peut être null. La présence de cet argument indique que le client est capable de prendre en charge la fonctionnalité de configuration, mais n’oblige pas le client à fournir des données de configuration pour un élément configurable spécifique.

La méthode Merge exécute une fusion de la base de données active et du module actif. La fusion joint les composants du module à la fonctionnalité identifiée par Fonctionnalité. La racine de l’arborescence de répertoires du module est redirigée vers l’emplacement donné par RedirectDir.

Syntaxe

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

Paramètres

Fonctionnalité

Nom d’une fonctionnalité dans la base de données.

RedirectDir

Clé d’une entrée dans la table Répertoire de la base de données. Ce paramètre ne peut pas avoir de valeur nulle ou être une chaîne vide.

pConfiguration

L’argument pConfiguration est une interface implémentée par le client. L’argument peut être null. La présence de cet argument indique que le client est capable de prendre en charge la fonctionnalité de configuration, mais n’oblige pas le client à fournir des données de configuration pour un élément configurable spécifique.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Une fois la fusion terminée, les composants du module sont attachés à la fonctionnalité identifiée par Fonctionnalité. Cette fonctionnalité n’est pas créée et doit être une fonctionnalité existante. Le module peut être attaché à des fonctionnalités supplémentaires à l’aide de la méthode Connect .

Les modifications apportées à la base de données sont enregistrées si et uniquement si la méthode CloseDatabase est appelée avec bCommit défini sur TRUE.

Si des conflits de fusion se produisent, y compris des exclusions, ils sont placés dans l’énumérateur d’erreur pour une récupération ultérieure, mais ne provoque pas l’échec de la fusion. Les erreurs peuvent être récupérées via la propriété Errors . Les erreurs et les messages d’information sont publiés dans le fichier journal actuel.

Lorsque la fusion échoue en raison d’une configuration de module incorrecte, la fonction MergeEx retourne E_FAIL. Cela inclut les erreurs msmErrorType suivantes : msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItemet msmErrorDataRequestFailed. Ces erreurs entraînent l’arrêt de la fusion immédiatement lorsque l’erreur est rencontrée. L’objet error est toujours ajouté à l’énumérateur lorsque MergeEx retourne E_FAIL. Pour plus d’informations sur les erreurs msmErrorType, consultez get_Type Function (Error Object). Toutes les autres erreurs entraînent le retour de MergeEx S_FALSE et entraînent la poursuite de la fusion.

C++

Consultez La fonction MergeEx .

Configuration requise