removablemedia_get_info()

#include <bps/removablemedia.h>
 

BPS_API int removablemedia_get_info(removablemedia_info_t **pinfo)

Since:

BlackBerry 10.2.0

Arguments:

pinfo

If this function successfully completes, this pointer is populated with the Removable Media information. The caller must call the removablemedia_free_info() function when finished using the info value. If the function does not complete successfully, the pointer is set to NULL.

Library:

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

Description:

The removablemedia_get_info() function gets the current Removable Media information. Details about the removable media can be extracted using the removablemedia_info_get_*() functions. removablemedia_free_info() must be used on the Removable Media information structure when your application is finished using it.

Information for multiple removable media devices or partitions on removable media devices may be available. Use removablemedia_info_get_next() to retrieve this information. However, removablemedia_free_info() must be called on the removablemedia_info_t structure retrieved from this function, to ensure no memory is leaked.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.