Runtime_GetModuleInfo()

Examples


The Runtime_GetModuleInfo() function retrieves the major and minor version and the build number from the application dictionary. The values returned correspond to the selections made in one of the following locations:

 

Syntax

Runtime_GetModuleInfo(product_ID, module, minor_version, build_number)

Parameters

product_ID – An integer specifying the product ID of the dictionary from which module information is being retrieved.

module – An integer indicating the module for which version numbers are being retrieved.

minor_version – A returned integer value containing the minor version of the specified module.

build_number – A returned integer value containing the build number of the specified module.

Return value

An integer indicating the major version of the specified module.

Comments

When you use the Create Chunk Dictionary window or the Auto-Chunk window in Dexterity Utilities to create a chunk dictionary, you specify a module and the major and minor version numbers and build number associated with that module. When the chunk dictionary is “unchunked,” the major and minor version numbers and build number for the specified accounting module are written to the application dictionary. Typically, the version numbers are retrieved from the application dictionary and displayed in the application’s About Box.

When an application is updated, the update chunk should use updated version numbers. This allows the new version numbers to be written to the application dictionary when the update chunk is installed. The updated version numbers will appear wherever you’ve used them in the application. Note that the same module must have been specified for both the original and the update dictionary chunks so the proper set of version numbers will be updated.

For example, assume the chunk dictionary used to install the first version of an application had a major version number of 1, a minor version number of 0 (Version 1.0), and a build number of 1. When the application is updated, the chunk dictionary for the update could be assigned a major version number of 1, a minor version number of 1 (Version 1.1), and a build number of 2.


Documentation Feedback