gc_LinedevToCCLIBID( )

---

Termination Events | Cautions | Errors | Example | See Also

Name:	int gc_LinedevToCCLIBID(linedev, cclibid)
Inputs:	LINEDEV linedev	line device
	int *cclibid	pointer to location of library identification code
Returns:	0 if successful <0 if failure
Includes:	gclib.h gcerr.h
Category:	library information
Mode:	synchronous
Platform and Technology:	All

Description

The gc_LinedevToCCLIBID( ) function returns the call control library ID of the call control library that opened the specified line device.

Parameter	Description
linedev	Global Call line device handle
cclibid	points to destination for call control library ID associated with this line device

Termination Events

None

Cautions

None

Errors

If this function returns <0 to indicate failure, use the gc_ErrorInfo( ) function to retrieve the reason for the error. See the "Error Handling" section in the Global Call API Programming Guide. All Global Call error codes are defined in the gcerr.h file. If the error returned is technology specific, see the technology-specific error header file(s) for the error definition (for example, ccerr.h or isdnerr.h file for the ISDN call control library).

Example

#include <stdlib.h>
#include <stdio.h>
#include <gclib.h>
#include <gcerr.h> 
/*
 * This procedure prints the cclib information associated with the specified linedev
*/
void print_cclibid_info(LINEDEV linedev)
{
     int               cclibid; 
     if (gc_LinedevToCCLIBID(linedev, &cclibid) == GC_SUCCESS) {
          printf("The cclibid for linedev %ld is %d\n", linedev, cclibid);
     } else {
          /* Do error handling */
     }
} 

See Also

• gc_CCLibIDToName( )
• gc_OpenEx( )

Click here to contact Telecom Support Resources