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

sk_pushDefaultHandler()

Description

The sk_pushDefaultHandler() function pushes aHandlerFunc onto the stack of default handler functions. It is called before any existing handler functions on the stack. If no other handler functions apply, then the next highest function on the stack is called. This function is also available as skts_pushDefaultHandler().

Syntax

int sk_pushDefaultHandler(void *aTag, HandlerFunc* aHandlerFunc);

Threadsafe Syntax

int skts_pushDefaultHandler( void *aTag, HandlerFunc* aHandlerFunc );

Parameters

The function parameters are shown in the table below.

Argument | Description
--- | ---
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:

SK_LOST_LLC | This return value indicates that your application lost contact with the LLC.