Méthode ConfigureModule. ProvideTextData

La méthode ProvideTextData est appelée par Mergemod.dll pour récupérer des données de texte à partir de l’outil client. Mergemod.dll fournit le nom à 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 chargé d’allouer les données, mais Mergemod. dllis 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 pas de données de configuration pour cette valeur de nom , la fonction doit retourner S _ false. Dans ce cas Mergemod.dll ignore la valeur de l’argument ConfigData et utilise la valeur par défaut de la table ModuleConfiguration.

Tout code de retour autre que S _ OK ou s _ false entraîne la journalisation d’une erreur (si un journal est ouvert) et entraîne l’échec de la fusion.

Étant donné que cette fonction suit la convention BSTR standard, NULL est équivalent à 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 de retour

Cette méthode ne retourne pas de valeur.

Notes

Le client peut être appelé plusieurs 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 n’entraîne aucun appel au client.

C++

Consultez fonction ProvideTextData.

Spécifications

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