Previous Topic: CreateDetectedSoftwareReleaseNext Topic: CreateDetectedSoftwareReleaseInstance


CreateDetectedSoftwarePatch

The CreateDetectedSoftwarePatch function adds a record to the software detection output file when the script detects a patch of a particular release. Add this function for every patch that you have included in the Intellisig script.

Function format:

CreateDetectedSoftwarePatch (ProductName as String, ProductVersionLabel, as String, ReleaseName as String, ReleaseVersionLabel as String, PatchName as String, PatchVersionLabel as String, OptionalProperties as String) as an integer

Example:

CreateDetectedSoftwarePatch ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "KB971033 x64 64 en-us", "Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Activation Checker Update")

Note: Called this function after calling the CreateDetectedSoftwareRelease function within each script.

Input Parameters

This function has the following input parameters:

ProductName

Specifies the name of the product that the patch 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 release that the patch belongs to. You must have called the CreateDetectedSoftwareRelease function for this release within the script.

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.

PatchName

Specifies the name of the detected software patch.

Note: A patch cannot have the same name as the release or product to which it belongs. The patch name and version label must be unique within each Intellisig software definition chain. Two patches with the same name within an Intellisig are treated as the same patch only if they have the same parent definitions, regardless of optional parameters. If the same patch is detected using two different Intellisigs, two separate detected records are created, one for each Intellisig.

PatchVersionLabel

Specifies the version label of the patch.

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

OptionalProperties

Specifies the optional properties associated with the detected software patch. Following optional properties are available for patches:

VersionNumber

Specifies the version number of the patch.

Language

Specifies the language in which the patch is installed.

Bitness

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

Architecture

Specifies the architecture name that the patch uses.

Manufacturer

Specifies the patch manufacturer name.

Category

Specifies the patch category.

ManufacturerUUID

Specifies the UUID of the patch manufacturer.

CategoryUUID

Specifies the UUID of the patch category.

Description

Specifies the description of the patch.

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.