Purpose

Format and send an attribute change event to the Event Server.

Syntax

#using Spo.SPDlib
SPD_errorType SPDReportValue
(
   string objectClass,
   string objectName,
   string hostName,
   string application,
   string applicationQualifier,
   string timeValue,
   int attrCount,
   string [] attrNames,
   string [] attrValues
);

Description

This function formats and sends an attribute change event to the Event Server.

objectClass

identifies the class of the object that contains the attributes whose values are being reported (for example, a disk drive or application).

objectName

identifies the instance of the object class (for example, a disk drive name or application name).

hostName

identifies the name of the host on which the object instance resides.

application

identifies the application which is raising the alert. Specify NULL if the application is the same as the application that you specified on the call to SPDInitClient.

applicationQualifier

further qualifies the application in the case where more than one instance of the application may be present. Specify NULL if the application qualifier is the same as the application qualifier that you specified on the call to SPDInitClient or if the application does not need to be further qualified.

timeValue

is the time to be associated with the reporting of the value. Specify NULL if no time is to be associated with the reporting of the value.

attrCount

is the number of attributes whose values are being reported for the specified object.

attrNames

is a list of the attribute names whose values are being reported. There must be attrCount entries in this list. It is the responsibility of the calling program to allocate the memory for this list. There is a one-to-one correspondence between the entries in the attrNames and attrValues lists. Names in this list cannot be NULL.

attrValues

is a list of the attribute values being reported. There must be attrCount entries in this list. It is the responsibility of the calling program to allocate the memory for this list. There is a one-to-one correspondence between the entries in the attrNames and attrValues lists. Values in this list can be NULL.

Return Value

The return value indicates whether an error occurred, as follows.

See Also

See also the following client functions: