You are here: SwitchKit® Development Environment - TCAP Interface User’s Guide > 5 SwitchKit TCAP Abstraction Layer > sktal_setTCAPDialogueHandler ()

sktal_setTCAPDialogueHandler ()

Description

Specifies a function to be invoked for incoming messages within a given transaction (identified by the Dialogue ID). The incoming event and the Dialogue ID invoke the handler; the handler should examine the event and invoke either sk_recvTCAPDialogue or sk_recvTCAPComponent.

Syntax

int sktal_setTCAPDialogueHandler(int instanceId, unsigned dialogueId, SKTAL_TCAP_DialogueHandler handler, void *tag);

Input Parameters

Argument | Description
--- | ---
instanceID | Instance for given node/stack/SNN combination
dialogueId | TCAP dialogue ID
handler | TCAP dialogue handler function. The prototype for new dialogue handler is: typedef int (*SKTAL_DialogHandler)(int instanceId, SKTAL_EVENT *ev, void *tag);

.

Input/Output Parameters and Output Parameters

None

Return Value

SKTAL_SUCCESS: If method is successful.

SKTAL return code as defined in Appendix C, SKTAL Return Codes.

In PPL, a condition that, when met, drives a state machine (PPL Component) from one state to another, by invoking an associated Primitive. In PPL files, an Event is marked by an arrow and text.
See Transaction Capability Application Part.