Name

omni_get_value − As a client procedure, omni_get_value obtains the value of a variable on a remote VMD. 

As a server procedure, omni_get_value obtains the value referred to by a write indication. 

Syntax

extern unsigned long int omni_get_value [_a](
       unsigned long int     ∗invoke_id,
       omni_l_handle         handle,
       omni_l_handle         method_handle,
       void                  ∗receiving_struct,
       unsigned long int     receiving_struct_length,
       omni_l_handle         modifier_object,
       omni_r_iosb           ∗iosb,
       omni_r_ctrl           ∗ctrl);

Arguments

invoke_idaccess: write only mechanism: by reference optional argument An identifier assigned by DEComni.  This parameter is used for asynchronous calls only. 

handleaccess: read only mechanism: by value In a client call, the identifier of a loaded variable definition. 

In a server call, the context value returned by the get_indications procedure call that delivered the write indication. 

method_handleaccess: read only mechanism: by value optional argument Method_handle modifies the default presentation of a variable. 

receiving_struct
  access: write only mechanism: by reference A data structure to receive the value of the object.

receiving_struct_length
access: read only mechanism: by value The size of the structure to receive data.

modifier_objectaccess: read only mechanism: by value optional argument Reserved for future use. 

iosbaccess: write only mechanism: by reference optional argument The DEComni I/O status block.  The iosb parameter is the address of the status block. 

ctrlaccess: read only mechanism: by reference optional argument A control structure to specify an event flag.  The ctrl parameter is the address of the control structure.