Version Property

Returns an A-Shell version string.

Syntax

Application.Version(VersionType)

Parameters

VersionType

A VersionTypeEnum value that determines the format and section of the A-Shell version string to return.

Return Value

A String value indicating the version of A-Shell. The full version string of  A-Shell conforms to the AMOS versioning format, and is of the form:

”A-Shell Version a.b[c](d)[-e]”

The values of a,b,c,d, and e correspond to the AMOS Version parts VMajor, VMinor, VSub, VEdit and VPatch.

Remarks

The following table shows the return string for each possible value of the VersionType parameter for A-Shell Version 4.7A(480)-1:

VersionTypeEnum Value

Return String

jbvtFullString

A-Shell Version 4.7A(480)-1

jbvtVerString

4.7A(480)-1

jbvtVMajor

4

jbvtVMinor

7

jbvtVSub

A

jbvtVEdit

480

jbvtVPatch

1

 

Checking the A-Shell version is particularly important in implementation of the Ping function on the IXcallBlock interface when developing COM-based XCALL routines.

Because the various A-Shell interfaces may be continually extended, presence of a particular interface does not guarantee implementation of all properties, methods and functions on that interface. The A-Shell version should therefore be checked in order to ensure that the version of A-Shell in use does support all the required automation (and any other) features.

Although not maintaining full interface compatibility between versions contravenes the normal COM and Microsoft conventions, it removes the need to introduce sequences of similar, but extended interfaces each time new methods are added. A particularly good example of this ‘interface mess’ is the Microsoft HTML Object Library, which contains the IHTMLWindow, IHTMLWindow2, and IHMTLWindow3 interfaces, as well as numerous other examples.