SPDDeleteObject

Purpose

Format and send a delete object event to the Event Server.

Syntax

#using Spo.SPDlib
SPD_errorType SPDDeleteObject
(
   string objectClass,
   string objectName,
   string hostName,
   string application,
   string applicationQualifier,
   string timeValue
);

Description

This function formats and sends a delete object event to the Event Server.

objectClass

identifies the class of the object being deleted (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 that 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 deletion of the object. Specify NULL if no time is to be associated with the deletion of the object.

Return Value

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

Return

Indication

SPD_normal

No error

SPD_notInitialized

SPDInitClient not called previously

SPD_badClass

Bad objectClass parameter

SPD_badName

Bad objectName parameter

SPD_badHost

Bad hostName parameter

SPD_badTime

Bad time string

SPD_commFailure

Communications problem

SPD_errException

A .NET runtime exception occurs