cc_GetCRN( )

Description | Cautions | Example | Errors | See Also

Name:	int cc_GetCRN(crnp, evtdatap)
Inputs:	CRN *crnp	pointer to the CRN
	void *evtdatap	pointer to an event block
Returns:	0 on success < 0 on failure
Includes:	cclib.h
Category:	System tools
Mode:	synchronous
Technology:	BRI/2; BRI/SC; PRI (all protocols)

Description

The cc_GetCRN( ) function retrieves the call reference number for the event in the event queue pointed to by evtdatap. The evtdatap pointer may be acquired using the sr_getevtdatap( ) function in the Dialogic Standard Runtime Library (SRL).

If the event is channel or time slot related and not call related, cc_GetCRN( ) returns a value < 0. If 0 is returned, the event is call related and the call reference number will be in the location pointed to by crnp.

Parameter	Description
crnp:	The address where the returned call reference number (CRN) is stored.
evtdatap:	Pointer to the structure containing the event data block. The pointer value is acquired using the SRL function sr_getevtdatap( ).

Cautions

None

Example

#include <windows.h>   /* For Windows applications only */  
#include <stdio.h>  
#include <errno.h>  
#include "srllib.h"  
#include "dtilib.h"  
#include "cclib.h"  
main()  
{  
   .  
   .  
   .  
   .  
   if ( sr_enbhdlr( devhdl,CCEV_DISCONNECTED,discCallHdlr ) < 0 )  
   {  
        printf( "dtiEnable for DISCONNECT failed:  %s\n",  
                              ATDV_ERRMSGP( SRL_DEVICE ) );  
        return( 1 );  
   }  
   .  
   .  
   .  
   .  
   while (1)  
   {  
      /* wait for network event */  
        sr_waitevt(-1);   
   }  
}  
/***************************************************/  
/* discCallHdlr - disconnect the active call       */  
/***************************************************/  
int discCallHdlr( )  
{  
    int devindx;  
    int dev;  
    int len;  
    void *datap;  
    CRN crn;  
    dev = sr_getevtdev();  
    len = sr_getevtlen();  
    datap = sr_getevtdatap();  
    cc_GetCRN (&crn, datap);   
          
    if ( cc_DropCall( crn,NORMAL_CLEARING,EV_ASYNC ) < 0 )  
    {  
        int lasterr = cc_CauseValue(dev);  
        char *errmsg;  
        if ( cc_ResultMsg(dev,lasterr,&errmsg) == 0 )  
            printf( "\tcc_DropCall() Error: ( %x ) %s\n",lasterr,errmsg);  
    }  
                                     
    return( 0 );  
}

Errors

If the function returns < 0 to indicate failure, use the cc_CauseValue( ) function to retrieve the reason code for the failure. The cc_ResultMsg( ) function can be used to interpret the reason code. Error codes are defined in the files ccerr.h, isdnerr.h, and isdncmd.h.

Typically, a < 0 return code for the cc_GetCRN( ) function indicates that the function reference (the device number) is not valid for the function call.

See Also

• cc_WaitCall( )
• cc_MakeCall( )

Click here to contact Dialogic Customer Engineering