You are here: SwitchKit® Development Environment Programmer’s Guide > 6 Handler Functions > sk_popTCAPHandler()
Description
Use the sk_popTCAPHandler() function to remove the top of the TCAP handler stack for the specified stack and subsystem number and set aRtndHandlerFunc to point to this function. This function is also available as skts_popTCAPHandler().
int sk_popTCAPHandler(int aStackID, int anSSN, void **aRtndTag, HandlerFunc **aRtndHandlerFunc);
int skts_popTCAPHandler(int aStackID, int anSSN, void **aRtndTag, HandlerFunc **aRtndHandlerFunc);
The function parameters are shown in the table below.
Argument |
Description |
---|---|
aStackID |
Stack ID |
anSSN |
Sub-system number |
aRtndTag |
Output parameter that will contain the tag value that was originally specified when the handler was pushed on the handler stack. |
aRtndHandlerFunc |
Output parameter that will contain the message handler function that was originally specified when the handler was pushed on the handler stack. |
Possible return values for this function:
OK |
TCAP handler functionality was successfully popped. |
SK_EMPTY |
Unable to pop handler. |