You are here: SwitchKit® Development Environment Programmer’s Guide > 6 Handler Functions > sk_pushTCAPHandler()
Description
Use the sk_pushTCAPHandler() function to push the handler function, aHandlerFunc, onto the TCAP handler stack for the specified stack and subsystem number. This function is also available as skts_pushTCAPHandler().
int sk_pushTCAPHandler(int aStackID, int anSSN, void *aTag, HandlerFunc* aHandlerFunc);
int skts_pushTCAPHandler(int aStackID, int anSSN, void *aTag, HandlerFunc* aHandlerFunc);
The function parameters are shown in the table below.
|
Argument |
Description |
|---|---|
|
aStackID |
Stack ID |
|
anSSN |
Sub-system number |
|
aTag |
An application defined pointer which will be returned to the application when a handler is invoked. |
|
aHandlerFunc |
A pointer to a function that is designed to handle messages. |
Possible return values for this function:
|
OK |
TCAP handler functionality was successfully pushed. |
|
SK_BAD_LICENSE |
TCAP handler functionality was not successfully unlocked. |