omni_get_handle_by_name(3) — Subroutines
Name
omni_get_handle_by_name − The omni_get_handle_by_name procedure locates the handle of a specified object definition.
Syntax
extern unsigned long int omni_get_handle_by_name (
omni_l_handle scope,
omni_l_classes class,
omni_t_mms_id_nt def_name,
unsigned long int def_name_length,
omni_l_handle ∗handle);
Arguments
scopeaccess: read only mechanism: by value A handle indicating the scope of the search. The scope parameter is typically the handle of a VMD or a domain. DEComni limits its search to the specified VMD or domain.
The scope parameter is the handle of a VMD (obtained using omni_define ) or a domain (obtained by a previous call to omni_get_handle_by_name).
classaccess: read only mechanism: by value One of the constants shown in the following table to indicate the class of definition to search for:
| Constant | Meaning |
| omni_c_cls_dom | Domain |
| omni_c_cls_pi | Program invocation |
| omni_c_cls_var | First variable type found |
| omni_c_cls_named_var | Named variable |
| omni_c_cls_unnamed_var | Unnamed variable |
| omni_c_cls_var_list | Variable list |
| omni_c_cls_mms_named_type | MMS Named Type |
| omni_c_cls_app_named_type | Application Named Type |
def_nameaccess: read only mechanism: by reference The name of the definition to search for.
def_name_lengthaccess: read only mechanism: by value The length of the def_name in characters.
handleaccess: write only mechanism: by reference A location to receive the definition handle.