CA Client Automation - 14.0

PDF
English

CreateDetectedSoftwareProduct

The CreateDetectedSoftwareProduct function adds a record to the software detection output file when the script detects a product that is related to the Intellisig.
cla140
The CreateDetectedSoftwareProduct function adds a record to the software detection output file when the script detects a product that is related to the Intellisig.
Function format:
CreateDetectedSoftwareProduct (ProductName as String, ProductVersion as String, OptionalProperties as String) as an integer
Example:
 
CreateDetectedSoftwareProduct(("Microsoft Windows 7 Ultimate", "6.1", "VersionNumber=6.1  |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Product")
Call this function before calling the CreateDetectedSoftwareRelease function, which creates the release of the product.
Input Parameters
This function has the following input parameters:
  • ProductName
    This parameter specifies the product name of the detected software.
    The product name must be unique within the Intellisig. Two products with the same name within an Intellisig are treated as the same product regardless of optional parameters.
  • 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.
  • OptionalProperties
    This parameter specifies the optional properties that are associated with the detected software product. Following optional properties are available for products:
    • VersionNumber
      This property specifies the version number of the product.
    • Language
      This property specifies the product language.
    • Bitness
      This property specifies whether the product uses 32-bit or 64-bit architecture.
    • Architecture
      This property specifies the architecture name that the product uses.
    • Manufacturer
      This property specifies the name of the product manufacturer.
    • Category
      This property specifies the name of the product category.
    • ManufacturerUUID
      This property specifies the UUID of the product manufacturer.
    • CategoryUUID
      This property specifies the UUID of the product category.
    • Description
      This property specifies the description of the product.
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.