Metodo ConfigureModule.ProvideTextData

Il metodo ProvideTextData viene chiamato da Mergemod.dll per recuperare i dati di testo dallo strumento client. Mergemod.dll fornisce il nome dalla voce corrispondente nella tabella ModuleConfiguration.

Lo strumento deve restituire S_OK e fornire il testo di personalizzazione appropriato in ConfigData. Lo strumento client è responsabile dell'allocazione dei dati, ma Mergemod.dllis responsabile del rilascio della memoria. Questo argomento DEVE essere un oggetto BSTR . LPCWSTR NON è accettato.

Se lo strumento non fornisce dati di configurazione per questo valore name , la funzione deve restituire S_FALSE. In questo caso Mergemod.dll ignora il valore dell'argomento ConfigData e usa il valore predefinito dalla tabella ModuleConfiguration.

Qualsiasi codice restituito diverso da S_OK o S_FALSE causerà la registrazione di un errore (se un log è aperto) e comporterà l'esito negativo dell'unione.

Poiché questa funzione segue la convenzione BSTR standard, Null equivale alla stringa vuota.

Sintassi

ConfigureModule.ProvideTextData(
  Name,
  ConfigData
)

Parametri

Nome

Nome dell'elemento per il quale vengono recuperati i dati.

ConfigData

Puntatore al testo di personalizzazione.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Il client può essere chiamato non più di una volta per ogni record nella tabella ModuleConfiguration. Si noti che Mergemod.dll non effettua mai più chiamate al client per lo stesso valore "Name". Se nella tabella ModuleSubstitution non viene usato alcun record, una voce nella tabella ModuleConfiguration non causa chiamate al client.

C++

Vedere La funzione ProvideTextData.

Requisiti

Requisito	Valore
Versione	Mergemod.dll 2.0 o versioni successive
Intestazione	Mergemod.h
DLL	Mergemod.dll