Previous Topic: CreateDetectedSoftwareReleaseInstanceNext Topic: LogDetectedSoftwareError


CreateDetectedSoftwarePatchInstance

The CreateDetectedSoftwarePatchInstance function adds a record to the software detection output file when the script detects an instance of a particular patch.

Function format:

CreateDetectedSoftwarePatchInstance (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: CreateDetectedSoftwarePatchInstance

CreateDetectedSoftwarePatchInstance ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "KB971033 x64 64 en-us", "", "Origin=Forward Inc |TrustLevel=5 |")

Note: This function must be called after calling the CreateDetectedSoftwarePatch function within each script. The CreateDetectedSoftwarePatchInstance function can be called as many times as the number of instances. Each instance gets a separate discovered software record.

Note: If two different Intellisigs detect the same software instance, two discovered software records are created, one for each Intellisig.

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.

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.

PatchName

Specifies the name of the detected software patch. You must have called the CreateDetectedSoftwarePatch function for this release within the script.

PatchVersionLabel

Specifies the version label of the patch.

OptionalProperties

Specifies the optional properties associated with the discovered software instance. Following optional properties are available for instances:

ProductGUID

Specifies the product UUID as detected by the script.

Label

Specifies a unique label for the instance.

Origin

Specifies the name of the Intellisig creator.

TrustLevel

Specifies the trust level of the creator of the Intellisig, script, or both.

InstallPath

Specifies the path to the product installation directory or the executable on the agent computer.

SerialNumber

Specifies the serial number of the instance.

LastAccessed

Specifies date and time when the instance was last accessed. Specify the value in the following format: yyyy-mm-dd:hr:mm. This value is assumed to be in local time.

Note: All other functions in dmscript that deal with time, operate in local time. Dmscript converts the time value to Unix format (seconds since 1-1-1970 UTC) before output. DSM Explorer displays this using the local time zone on the machine on which it is running.

CustomData

Specifies any other custom data you want store for the instance.

Return Values

CA_SWDETECT_OK

Indicates that the function completed the operation successfully.

CASWDETECT_BADARGS

Indicates that the 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.