Méthode ConfigureModule.ProvideTextData
La méthode ProvideTextData est appelée par Mergemod.dll pour récupérer des données texte à partir de l’outil client. Mergemod.dll fournit l’élément Name à partir de l’entrée correspondante dans la table ModuleConfiguration.
L’outil doit retourner S_OK et fournir le texte de personnalisation approprié dans ConfigData. L’outil client est responsable de l’allocation des données, mais Mergemod.dll est responsable de la libération de la mémoire. Cet argument DOIT être un objet BSTR . LPCWSTR n’est PAS accepté.
Si l’outil ne fournit aucune donnée de configuration pour cette valeur Name, la fonction doit retourner S_FALSE. Dans ce cas, Mergemod.dll ignore la valeur de l’argument ConfigData et utilise la valeur Default de la table ModuleConfiguration.
Tout code de retour autre que S_OK et S_FALSE entraîne la journalisation d’une erreur (si un journal est ouvert) et entraîne l’échec de la fusion.
Comme cette fonction suit la convention BSTR standard, null équivaut à la chaîne vide.
Syntaxe
ConfigureModule.ProvideTextData(
Name,
ConfigData
)
Paramètres
-
Nom
-
Nom de l’élément pour lequel les données sont récupérées.
-
ConfigData
-
Pointeur vers le texte de personnalisation.
Valeur retournée
Cette méthode ne retourne pas de valeur.
Notes
Le client ne peut pas être appelé plus d’une fois pour chaque enregistrement de la table ModuleConfiguration. Notez que Mergemod.dll n’effectue jamais plusieurs appels au client pour la même valeur « Name ». Si aucun enregistrement de la table ModuleSubstitution n’utilise la propriété, une entrée de la table ModuleConfiguration ne provoque aucun appel au client.
C++
Consultez Fonction ProvideTextData.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version |
Mergemod.dll 2.0 ou ultérieur |
| En-tête |
|
| DLL |
|