SPD_DeleteObject

Purpose

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

Syntax

#include "spd.h"
 
SPD_errorTP SPD_DeleteObject(
   char *objectClass,
   char *objectName,
   char *hostName,
   char *application,
   char *applicationQualifier,
   time_t timeValue
);

Description

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 deleting the object. Specify NULL if the application is the same as the application that you specified on the call to SPD_InitClient.

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 SPD_InitClient.

timeValue

is the local time to be associated with deletion of the object. Specify the result of the C time system function, or 0 if no local time is to be associated with deletion of the object.

Return Value

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

Return

Indication

SPD_normalCN

No error

SPD_notInitializedCN

SPD_InitClient not called previously

SPD_badClassCN

Bad objectClass parameter

SPD_badHostCN

Bad hostName parameter

SPD_badNameCN

Bad objectName parameter

SPD_commFailureCN

Communications problem