iTixRuntime::GetVersionString

Retrieves a named string from the extension DLL's VERSIONINFO resources. You can use this function to obtain strings that you stored in your extension DLL VERSIONINFO resources during or after the build, for example for any dynamic configuration.

BOOL GetVersionString(
    const TCHAR *pszName,
    TCHAR *pszResult,
    UINT uResultCount
);

Parameters

pszName

Name of the VERSIONINFO string that must be retrieved. See the Win32 VerQueryValue documentation for names of the standard strings, or use whatever string names that you added to the extension DLL's VERSIONINFO resource.

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 string was found, or FALSE (zero) if the string does not appear in the extension DLL's VERSIONINFO resource. If the pszResult buffer is too small to receive the entire string, the string is silently truncated. No error indication is given in that case.