Avaya DXX-1015-01 用户手册

下载
页码 74
ADU.IncrValue
Issue 1.0 June 2002
59
ADU.IncrValue
IDL Syntax
ORBStatus IncrValue( in ADU_ID aduid, in string name, in long incr, 
 
 out string newvalue ) ; 
Description
This method is a useful alternative to using SetOneValue and GetOneValue to modify a value 
when there is a risk that two applications might conflict.
This method changes one ADU data element. If the element does not exist it is created. An element 
that exists is overwritten if permission allows. The value of the element is treated as a number and 
is converted to a long integer (by use of the C function atol). The specified increment is added, and 
the element’s value is set to the result. Elements that do not exist are treated as if they contained a 
zero (0). The increment may be a negative value.
The atol function is robust in that if it cannot recognize a number, it returns 0. The method stores 
the resulting, incremented value as a decimal digit string without extraneous spaces or leading 
zeros. Thus, incrementing “x2” by one results in “1” and incrementing “00034E6” by one results 
in “35”.
Input Parameters
Output Parameters
Returns
C Program Example
char *result;
status = Vesp_Request( "ADU.IncrValue", callback, 0x2132, session,
aduid, "some_numeric_element", 1L, &result );
ADU.Monitor
IDL Syntax
ORBStatus Monitor( in string monitorcriteria ) ; 
Description
This method changes Assign criteria. It works like Assign in all respects. You must have 
previously assigned (and have not since deassigned) to use this method.
aduid
Agent Data Unit Identifier.
name
The name of the ADU element to change or create.
incr
Increment value.
newvalue
The new value of the element, after the increment.
VESP_SUCCESS 
Request was successful.
VESP_ERROR
ADU not found, or the element cannot be changed.