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.

Usage syntax

LONG SE_rasterband_get_info_list (SE_CONNECTION connection, LONG rastercolumn_id, SE_RASBANDINFO **rasband_list, LONG *count_addr);

Parameters
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
Description

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.

Returns

SE_SUCCESS
SE_DB_IO_ERROR

SE_INVALID_POINTER

SE_NET_FAILURE

SE_SDE_NOT_STARTED

Notes

∙ The application must free the memory used by this call. See SE_rasterband_free_info_list .