Desktop Management Scripting Language › Functions › Common Configuration Functions › CreateDetectedSoftwareRelease

CreateDetectedSoftwareRelease

The CreateDetectedSoftwareRelease function adds a record to the software detection output file when the script detects a release of a product on the agent computer.

Note: DMScript adds the record only if it finds the related product record in the MDB.

This function has the following format:

CreateDetectedSoftwareRelease (ProductName as String, ProductVersionLabel, as String, ReleaseName as String, ReleaseVersionLabel as String, OptionalProperties as String) as an integer

Example:

CreateDetectedSoftwareRelease ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "VersionNumber=6.1.7600 |Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Release")

Input Parameters

This function has the following input parameters:

ProductName

Specifies the product name that the release belongs to. You must have called the CreateDetectedSoftwareProduct function for this product within the script.

ProductVersionLabel

Specifies the version label of the product.

Note: The version label is used to identify the product together with its name. An empty value is allowed and is treated as a product with an empty version.

ReleaseName

Specifies the name of the discovered software release.

Note: A release can have the same name as the product. However, Intellisigs support different release names to help associate multiple releases with the same product. The release name and version label must be unique within each Intellisig chain. Two releases with the same name within an Intellisig are treated as the same release only if they share the same parent definitions, regardless of optional parameters. If the same release is detected using two different Intellisigs, two separate detected records are created, one for each Intellisig.

ReleaseVersionLabel

Specifies the version label of the release.

Note: The version label is used to identify the release together with its name. An empty value is allowed and is treated as a release with an empty version.

OptionalProperties

Specifies the optional properties associated with the discovered software release. Following optional properties are available for releases:

VersionNumber

Specifies the version number of the release.

Language

Specifies the language in which the release is installed.

Bitness

Specifies whether the release uses 32-bit or 64-bit architecture.

Architecture

Specifies the architecture name.

Manufacturer

Specifies the name of the release manufacturer.

Category

Specifies the release category.

ManufacturerUUID

Specifies the UUID of the release manufacturer.

CategoryUUID

Specifies the UUID of the release category.

Description

Specifies the description of the release.

Return Values

CA_SWDETECT_OK

Indicates that the function completed the operation successfully.

CASWDETECT_BADARGS

Indicates that one or more mandatory parameters passed to the function are blank.

CASWDETECT_FILE_ERROR

Indicates that the function was unable to write to the file. See the log file for more information.