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

PtRemoveWidgetData()

Remove data from the widget data chain

Synopsis:

int PtRemoveWidgetData( 
        PtWidget_t *widget, 
        PtWidgetClassRef_t *type, 
        long subtype );

Arguments:

widget: A pointer to the widget from whose chain you want to remove the data.
type: The class of the widget removing the data.
subtype: The subtype of data to remove. This is used to discriminate between multiple blocks of data added by the same widget class.

Description:

This function removes a piece of data from the widget data chain and frees the memory allocated for the data.

Returns:

0 if the data was found and released; -1 if it couldn't be found.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtAddWidgetData(), PtFindWidgetData(), PtFindNextWidgetData()