Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ApRemoveContext()

Remove the PhAB context from a PhAB application that you're using as a DLL

Synopsis:

int ApRemoveContext( ApContext_t *context );

Arguments:

context
A pointer to the context to remove. This argument should be the address of AbContext, a global data structure that PhAB puts in abmain.c.

Library:

Ap

Description:

This function removes a PhAB context from a PhAB application that you're using as a DLL. Call this function from the DLL's cleanup function.


Note: You must call ApRemoveContext() as many times as you successfully called ApAddContext(). After you've called ApRemoveContext(), your DLL must not call any PhAB functions.

Returns:

0 on success, or -1 on failure.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

ApAddContext(), ApRemoveClass()

"Making a DLL out of a PhAB application" in the Generating, Compiling, and Running Code chapter of the Photon Programmer's Guide