Dialogic IP Phone 05-2239-009 User Manual

479

Dialogic Corporation

This function is only supported in asynchronous mode. 

The gc_ReqService( ) function can be used to register an endpoint with a registration server 
(gateway in H.323 or registrar in SIP). Function parameters must be set as follows: 

target_type 

GCTGT_GCLIB_NETIF 

target_ID 

An IPT board device, obtained by using gc_OpenEx( ) with a devicename parameter of 
“N_iptBx” 

service_ID 

Any valid reference to an unsigned long; must not be NULL 

reqdatap 

A pointer to a GC_PARM_BLK containing registration information. 

respdatapp 

Not used in asynchronous mode; set to NULL. 

mode 

EV_ASYNC 

The registration information that can be included is protocol-specific as described in Table 38 and 
Table 39, below. 

To set the protocol type, the following parameter element is inserted into the GC_PARM_BLK 
referenced by reqdatap:

IPSET_PROTOCOL

IPPARM_PROTOCOL_BITMASK 
and one of the following parameter data values:

IP_PROTOCOL_H323

IP_PROTOCOL_SIP

IP_PROTOCOL_H323 | IP_PROTOCOL_SIP

The default value for the protocol, when not specified by the application, is IP_PROTOCOL_H323.

Registration options are specified by inserting the following parameter element into the 
GC_PARM_BLK referenced by reqdatap: 

IPSET_REG_INFO

IPPARM_OPERATION_REGISTER
and one of the following parameter data values: 

IP_REG_SET_INFO – override an existing registration value 

IP_REG_ADD_INFO – add a registration value 

IP_REG_DELETE_BY_VALUE – remove a specific registration value (i.e., local alias or 
supported prefix only) 

IP_REG_QUERY_INFO – query a SIP Registrar for existing bindings (SIP only) 

See 

, on page 279 for more information.