SE_stable_create

Creates an empty shape table (s-table)

Usage syntax

LONG SE_stable_create (const SE_ENVELOPE *extent, SE_COORDREF coordref, SE_STABLE *stable);

Parameters
extent The maximum extent of the shapes in the s-table; any shape that is not fully contained within the boundary is rejected.
coordref A pointer to the coordinate system structure for the shape table
stable Variable to receive the handle to the newly created stable
Description

SE_stable_create creates an empty shape table, ready to receive shapes using SE_stable_add_shape.

This function executes on the client only. An SE_INVALID_ENVELOPE error is returned if the minimum x- or y-extents are greater than or equal to the maximum x- or y-extents.

An SE_INVALID_POINTER error is returned if either the envelope or s-table handle are passed as null pointers to the function.

An SE_OUT_OF_CLMEM error is returned if insufficient memory is available to allocate space for the new s-table.

An SE_SDE_NOT_STARTED error is returned if SE_connection_create has not been executed successfully.

Returns

SE_SUCCESS
SE_INVALID_ENVELOPE

SE_INVALID_POINTER

SE_OUT_OF_CLMEM

SE_SDE_NOT_STARTED