SE_rasterband_get_info_list (deprecated) |
This function has been deprecated. See "Description" for details.
Retrieves an array of SE_RASBANDINFO structures for all accessible raster bands.
LONG SE_rasterband_get_info_list (SE_CONNECTION connection, LONG rastercolumn_id, SE_RASBANDINFO **rasband_list, LONG *count_addr);
connection | The connection handle |
rastercolumn_id | The raster column ID |
rasband_list | Address of a pointer in a dynamically allocated space that will contain an array of SE_RASBANDINFO structures |
count_addr | The number of raster bands in the SE_RASBANDINFO list |
SE_rasterband_get_info_list returns an array of SE_RASBANDINFO pointers that are defined. The total number of raster band structures is returned in the count_addr parameter. The application must free the rasterband_list to reclaim the memory allocated by this function.
A more efficient alternative to this function is the SE_raster_get_bands function, which is much more efficient since the records will be cached on the client side following the first execution. The SE_rasterband_get_info_list function will not cache the results and therefore should be replaced with a call to SE_raster_get_bands.
SE_SUCCESS
SE_DB_IO_ERROR
SE_INVALID_POINTER
SE_NET_FAILURE
SE_SDE_NOT_STARTED
∙ The application must free the memory used by this call. See SE_rasterband_free_info_list .