ConfigureModule.ProvideTextData (método)

La biblioteca Mergemod.dll llama al método ProvideTextData para recuperar datos de texto de la herramienta de cliente. Mergemod.dll proporciona el nombre (Name) de la entrada correspondiente en la tabla ModuleConfiguration.

La herramienta debe devolver S_OK y proporcionar el texto de personalización correspondiente en ConfigData. La herramienta de cliente es responsable de asignar los datos, pero Mergemod.dllis es responsable de liberar la memoria. Este argumento DEBE ser un objeto BSTR. NO se acepta LPCWSTR.

Si la herramienta no proporciona ningún dato de configuración para este valor Name, la función debe devolver S_FALSE. En este caso, Mergemod.dll omite el valor del argumento ConfigData y usa el valor Default de la tabla ModuleConfiguration.

Cualquier código de retorno que no sea S_OK o S_FALSE dará lugar a que se registre un error (si hay un registro abierto) y que no progrese la combinación.

Dado que esta función sigue la convención BSTR estándar, null es equivalente a una cadena vacía.

Sintaxis

ConfigureModule.ProvideTextData(
  Name,
  ConfigData
)

Parámetros

Nombre

Nombre del elemento para el que se recuperan los datos.

ConfigData

Puntero al texto de personalización.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Solo se puede llamar al cliente una vez por cada registro de la tabla ModuleConfiguration. Tenga en cuenta que Mergemod.dll nunca realiza varias llamadas al cliente para el mismo valor "Name". Si no hay ningún registro en la tabla ModuleSubstitution que use la propiedad, una entrada de la tabla ModuleConfiguration no provoca llamadas al cliente.

C++

Consulte ProvideTextData (función).

Requisitos

Requisito	Value
Versión	Mergemod.dll 2.0 o posterior
Encabezado	Mergemod.h
Archivo DLL	Mergemod.dll