Merge. MergeEx, méthode

La méthode MergeEx de l’objet Merge équivaut à la fonction Merge , à ceci près qu’elle accepte un argument supplémentaire. L’argument pConfiguration est une interface implémentée par le client. L’argument peut avoir la valeur null. La présence de cet argument indique que le client peut prendre en charge la fonctionnalité de configuration, mais n’impose pas au client de 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 actuel. La fusion attache les composants du module à la fonctionnalité identifiée par la 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 des répertoires de la base de données. Ce paramètre peut avoir la valeur null ou être une chaîne vide.

pConfiguration

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

Valeur de retour

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 la 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 Connecter .

Les modifications apportées à la base de données sont enregistrées si et seulement si la méthode FermerBase 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’erreurs pour une récupération ultérieure, mais n’entraînent pas l’échec de la fusion. Les erreurs peuvent être récupérées par le biais de 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 comprend les erreurs msmErrorType suivantes : msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItem et msmErrorDataRequestFailed. Ces erreurs provoquent l’arrêt immédiat de la fusion lorsque l’erreur se produit. L’objet d’erreur est toujours ajouté à l’énumérateur lorsque MergeEx retourne E _ Fail. Pour plus d’informations sur les erreurs msmErrorType, consultez obtenir le _ type, fonction (objet d’erreur). Toutes les autres erreurs provoquent le renvoi de S _ false par MergeEx et la poursuite de la fusion.

C++

Consultez fonction MergeEx .

Spécifications

Condition requise Valeur
Version
Mergemod.dll 2,0 ou version ultérieure
En-tête
Mergemod. h
DLL
Mergemod.dll