| SE_rasterband_alter | |
Alters a raster band’s characteristics
LONG SE_rasterband_alter (SE_CONNECTION connection, const SE_RASBANDINFO rasterband);
| connection | The connection handle |
| rasterband | An SE_RASBANDINFO structure to define the new characteristics of the raster band |
SE_rasterband_alter changes those characteristics of a raster band that can be modified after raster band creation. The raster band to modify is specified by the rasband_id in the SE_RASBANDINFO structure.
You cannot change the following characteristics:
∙ ID
∙ Raster column ID
∙ Raster ID
∙ Pixel depth
∙ Block width and height
∙ Sequence number
∙ Creation time
A convenient method to change a particular characteristic of a raster band is to retrieve the existing raster band definition into the SE_RASBANDINFO pointer with SE_rasterband_get_info_by_id. Modify the characteristic with one of the SE_rasbandinfo_set_* functions.
SE_SUCCESS
SE_DB_IO_ERROR
SE_INVALID_ALTER_OPERATION
SE_NET_FAILURE
SE_NO_ACCESS
SE_STREAM_IN_PROGRESS