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

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

Syntax

int sk_pushTCAPHandler(int aStackID, int anSSN, void *aTag, HandlerFunc* aHandlerFunc);

Threadsafe Syntax

int skts_pushTCAPHandler(int aStackID, int anSSN, void *aTag, HandlerFunc* aHandlerFunc);

Parameters

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.

Return Values

Possible return values for this function:

OK | TCAP handler functionality was successfully pushed.
SK_BAD_LICENSE | TCAP handler functionality was not successfully unlocked.

See Transaction Capability Application Part.