oms_aa_dest_status_set()
Abstract
Specifies an existing address as either a valid or an invalid destination.
Syntax
oms_aa_dest_status_set (oms_aa_handle, address, destination_status)
| Argument | Type | Description |
|---|---|---|
oms_aa_handle |
OmsT_Aa_Address_Handle |
Handle to the list for the specific address type |
address |
int |
Address whose destination status is to be set |
destination_status |
OmsT_Aa_Destination_Status |
Enumerated data type [can be either OmsC_Aa_Valid_Destination or OmsC_AA_Invalid_Destination] |
Return Type
void
No return value
Details
This procedure is useful when you want to specify a given destination address as valid or invalid—for example, if a node is only initiating voice calls in a scenario, you can specify that node’s address as an invalid destination. By default, all destination addresses are considered valid.
Example
From sna_sess_cntl process model, init_too exit execs:
{
/* Get interrupt parameters. */
intrpt_type = op_intrpt_type ();
intrpt_code = op_intrpt_code ();
/* Obtain the host address; note that this is required as */
/* it may have changed during auto-addressing. */
op_ima_obj_attr_get (my_objid, "Subarea Address", &host_address);
oms_aa_dest_status_set (oms_aa_handle, host_address
OmsC_Aa_Valid_Destination);
/* Advertise the host address also. */
oms_pr_attr_set (process_record_handle, "address", OMSC_PR_NUMBER,
(double) host_address, OPC_NIL);
}