iTixRuntime::ResolveSymbols

Resolve all symbolic expressions in a given string.

This function can be used to obtain the value of a single variable such as <INSTALLDIR>, or of a complete path, for example <INSTALLDIR>\Text.txt. It can also be used to evaluate runtime functions, for example <$sfn(<SystemFolder>\Notepad.exe)> or <@<HKLM>\Software\Microsoft\Windows\CurrentVersion\ProductId>.

Tip: To retrieve the expanded value of a single variable such as INSTALLDIR, you can use iTixRuntime::GetSymbol() instead.

BOOL ResolveSymbols(
    const TCHAR *pszString,
    TCHAR *pszResult,
    UINT uResultCount
);

Parameters

pszString

String with symbolic expressions that must be resolved.

pszResult

Pointer to the buffer that will receive the requested string value.

uResultCount

Size of the pszResult buffer expressed as number of TCHARs (i.e., bytes for an ANSI build, or WORDs for a Unicode build). The installer will copy at most uResultCount - 1 characters to the buffer, then terminate the result with '\0'.

Return value

Returns nonzero if the resolved string is not empty, or FALSE (zero) if it is. If the pszResult buffer is too small to receive the expanded string, the expansion is silently truncated. No error indication is given in that case.