CA Client Automation - 14.0

PDF
English

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.
cla140
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.
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
    This parameter specifies the product name that the release belongs to. You must have invoked the CreateDetectedSoftwareProduct function for this product within the script.
  • ProductVersionLabel
    This parameter specifies the version label of the product.
    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
    This parameter specifies the name of the discovered software release.
    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 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
    This parameter specifies the version label of the release.
    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
    This parameter specifies the optional properties that are associated with the discovered software release. Following optional properties are available for releases:
    • VersionNumber
      This property specifies the version number of the release.
    • Language
      This property specifies the language in which the release is installed.
    • Bitness
      This property specifies whether the release uses 32-bit or 64-bit architecture.
    • Architecture
      This property specifies the architecture name.
    • Manufacturer
      This property specifies the name of the release manufacturer.
    • Category
      This property specifies the release category.
    • ManufacturerUUID
      This property specifies the UUID of the release manufacturer.
    • CategoryUUID
      This property specifies the UUID of the release category.
    • Description
      This property specifies the description of the release.
Return Values
  • CA_SWDETECT_OK
    This value indicates that the function completed the operation successfully.
  • CASWDETECT_BADARGS
    This value indicates that one or more mandatory parameters that are passed to the function are blank.
  • CASWDETECT_FILE_ERROR
    This value indicates that the function was unable to write to the file. See the log file for more information.