navigator_window_cover_attribute_destroy()

Destroy a window cover attribute handle.

Synopsis:

#include <bps/navigator.h>

BPS_API int navigator_window_cover_attribute_destroy(navigator_window_cover_attribute_t *attribute)

Since:

BlackBerry 10.0.0

Arguments:

attribute: The window cover attribute handle.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The attribute handle is not needed after a call to navigator_window_cover_update() so it can be safely destroyed. If any label handles exist, they should be destroyed by calling navigator_window_cover_label_destroy() before calling this function.

Returns:

On success, BPS_SUCCESS. On failure, BPS_FAILURE with errno set and attribute will still be valid.