Skip to content

IWindowsInstallerBackendBinderExtension Interface

Interface all binder extensions implement.

MethodDescription
PostBackendBind(result)Called after all output changes occur and right before the output is bound into its final format.
PreBackendBind()Called before binding occurs.
ResolveMedia(mediaSymbol, mediaLayoutDirectory, layoutDirectory)Override layout location for a media.
SymbolsFinalized(section)Extension can process the intermediate before the Windows Installer data is created.
TryProcessSymbol(section, symbol, data, tableDefinitions)Called for each extension symbol that hasn’t been handled yet.
PropertyDescription
TableDefinitionsTable definitions provided by the extension.
WixToolset.Extensibility.dll version 5.0.0+41e11442b2ca93e444b60213b5ae99dcbab787d8

Called after all output changes occur and right before the output is bound into its final format.

public void PostBackendBind(
Data.IBindResult result
)
ParameterTypeDescription
resultData.IBindResultBind result to process.

Called before binding occurs.

public void PreBackendBind()

ResolveMedia(mediaSymbol, mediaLayoutDirectory, layoutDirectory) Method

Section titled “ResolveMedia(mediaSymbol, mediaLayoutDirectory, layoutDirectory) Method”

Override layout location for a media.

public string ResolveMedia(
WixToolset.Data.Symbols.MediaSymbol mediaSymbol,
string mediaLayoutDirectory,
string layoutDirectory
)
ParameterTypeDescription
mediaSymbolWixToolset.Data.Symbols.MediaSymbolMedia symbol.
mediaLayoutDirectorystringDefault media specific layout directory.
layoutDirectorystringDefault overall layout directory.

string Layout location or null to use the default processing.

Extension can process the intermediate before the Windows Installer data is created.

public void SymbolsFinalized(
WixToolset.Data.IntermediateSection section
)
ParameterTypeDescription
sectionWixToolset.Data.IntermediateSectionThe finalized intermediate section.

TryProcessSymbol(section, symbol, data, tableDefinitions) Method

Section titled “TryProcessSymbol(section, symbol, data, tableDefinitions) Method”

Called for each extension symbol that hasn’t been handled yet.

public bool TryProcessSymbol(
WixToolset.Data.IntermediateSection section,
WixToolset.Data.IntermediateSymbol symbol,
WixToolset.Data.WindowsInstaller.WindowsInstallerData data,
WixToolset.Data.WindowsInstaller.TableDefinitionCollection tableDefinitions
)
ParameterTypeDescription
sectionWixToolset.Data.IntermediateSectionThe linked section.
symbolWixToolset.Data.IntermediateSymbolThe current symbol.
dataWixToolset.Data.WindowsInstaller.WindowsInstallerDataWindows Installer data
tableDefinitionsWixToolset.Data.WindowsInstaller.TableDefinitionCollectionCollection of table definitions available for the output.

bool True if the symbol was handled, or false if not.

Table definitions provided by the extension.

public System.Collections.Generic.IReadOnlyCollection<WixToolset.Data.WindowsInstaller.TableDefinition> TableDefinitions { get; set; }