You are here: SwitchKit® Development Environment Programmer’s Guide > 6 Handler Functions > sk_popTCAPHandler()

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().

Syntax

int sk_popTCAPHandler(int aStackID, int anSSN, void **aRtndTag, HandlerFunc **aRtndHandlerFunc);

Threadsafe Syntax

int skts_popTCAPHandler(int aStackID, int anSSN, void **aRtndTag, HandlerFunc **aRtndHandlerFunc);

Parameters

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.

Return Values

Possible return values for this function:

OK | TCAP handler functionality was successfully popped.
SK_EMPTY | Unable to pop handler.

See Transaction Capability Application Part.