SetTransHandler()

SetTransHandler()

Description

This method sets a transaction handler for a given call reference ID.

Syntax

int SetTransHandler(int callrefid, SKIM_TransHandler h, void *tag);

Parameters

The input parameters are shown in the next table. There are no input/output parameters.

Argument	Description
callrefid	Call reference ID for which transaction handler is being registered.
h	Transaction handler. Protype for transaction handler function is: typedef int (SKIM_TransHandler)(SKIM_Trans &trans, void tag);
tag	This tag is returned when transaction handler is invoked.

Argument

Description

callrefid

Call reference ID for which transaction handler is being registered.

Transaction handler. Protype for transaction handler function is:

typedef int (*SKIM_TransHandler)(SKIM_Trans &trans, void *tag);

tag

This tag is returned when transaction handler is invoked.

Return Values

Possible return values for this API are:

SKIM_SUCCESS	No failure has occurred.
SKIM_TRANS_RECORD_ERROR	No transaction is active for given call reference ID.