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

sk_popChannelHandler()

Description

The sk_popChannelHandler() function removes the top of the handler stack for the specified span and channel and sets aHandlerFunc to point to this function.

Syntax

int sk_popChannelHandler(int aSpan, int aChannel, void **aRtndTag, HandlerFunc **aRtndHanderFunc);

Threadsafe Syntax

int skts_popChannelHandler(int aSpan, int aChannel, void **aRtndTag, HandlerFunc **aRtndHanderFunc

Parameters

The function parameters are shown in the table below.

Argument | Description
--- | ---
aSpan | Specifies the span.
aChannel | Specifies the channel.
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:

SK_EMPTY | The handler stack is empty.