diag_change_obj

Edit online

Purpose

Changes an object in the object class.

Syntax


#include     <diag/diagodm.h>
#include     <sys/cfgodm.h>
#include     <diag/DiagODM.h>

void diag_change_obj ( 
                                 void         *classp,
                                 void         *p_obj)

Description

The diag_change_obj subroutine takes, as input, the class symbol that identifies the object class to add to and a pointer to the data structure that contains the object to be changed. The application must first retrieve the object with a diag_get_list subroutine call, change the data values in the returned structure, and then pass that structure to the diag_change_obj subroutine.

Note: init_dgodm must be called before starting this subroutine.

Parameters

Parameter Description
classp A class symbol identifier returned from a diag_open_class subroutine. If the diag_open_class subroutine has not been called, then this is the structure name of the class normally defined in either the diag/diagodm.h file, diag/DiagODM.h file, or sys/cfgodm.h file.
p_obj Pointer to an instance of the structure corresponding to the object class referenced by the classp parameter.

Return Value

Upon successful completion, a value of 0 is returned. If the subroutine fails, a -1 is returned.