ctCloseSequence
Declaration
NINT ctCloseSequence(LONG seqhnd);
Description
Closes the sequence having the specified handle.
Return Values
Value |
Symbolic Constant |
Explanation |
---|---|---|
0 |
NO_ERROR |
Successfully created the sequence. |
900 |
SEQDUP_ERR |
A sequence having the specified name already exists. |
903 |
SEQTYP_ERR |
The specified sequence type contains an invalid combination of sequence type options. |
904 |
SEQINI_ERR |
The initial value specified for the sequence is out of range. |
905 |
SEQCUR_ERR |
The current value specified for the sequence is out of range. |
906 |
SEQLIM_ERR |
The limit value specified for the sequence is out of range. |
907 |
SEQINC_ERR |
The increment value specified for the sequence is out of range. |
901 |
SEQNAM_ERR |
An invalid sequence name was specified: the name is NULL, empty, or too long. |
See c-treeACE Error Codes for a complete listing of valid error values.
Example
ctSEQATTR seqattr;
NINT rc;
/*
** Create an incrementing sequence that starts with 1, increments by 3, and
** terminates with 100.
*/
strcpy(seqattr.seqnam, "MyFirstSequence");
seqattr.seqini = 1;
seqattr.seqinc = 3;
seqattr.seqlim = 100;
seqattr.seqtyp = ctSEQINC | ctSEQTRM | ctSEQLIM;
if ((rc = ctCreateSequence(&seqattr))) {
printf("Error: Failed to create the sequence: %d\n", rc);
} else {
printf("Successfully created the sequence.\n");
}
See also
ctCreateSequence, ctDeleteSequence, ctOpenSequence, ctCloseSequence, ctGetSequenceAttrs, ctSetSequenceAttrs, ctGetCurrentSequenceValue, ctSetCurrentSequenceValue, ctGetNextSequenceValue