SE_rasterband_alter

Alters a raster band’s characteristics.

Usage syntax

LONG SE_rasterband_alter (SE_CONNECTION connection, const SE_RASBANDINFO rasterband);

Parameters
connection The connection handle
rasterband An SE_RASBANDINFO structure to define the new characteristics of the raster band
Description

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 can not 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.

Returns

SE_SUCCESS
SE_DB_IO_ERROR

SE_INVALID_ALTER_OPERATION

SE_NET_FAILURE

SE_NO_ACCESS

SE_STREAM_IN_PROGRESS