tagViewReturnCode
Specifies the view operation's return code.
|
Name |
Value |
Description |
|
Original Errors |
||
|
VC_SUCCESS |
0 |
Operation succeeded |
|
VC_LOAD_FAILED |
100 (&H64) |
View load failed |
|
VC_OPEN_FAILED |
101 (&H65) |
View open failed |
|
VC_COMPOSE_FAILED |
102 (&H66) |
View compose failed |
|
VC_ROTOENTRY_FAILED |
103 (&H67) |
Caller has requested an operation not implemented by this view |
|
VC_OPEN_FAILED_PS |
500 (&H1F4) |
View open failed due to process server error |
|
VC_OPEN_FAILED_PSCONNECT |
501 (&H1F5) |
View open failed due to process server connection error |
|
Old (Redundant) Errors |
||
|
VC_OLD_GENERAL |
1 |
(OLD) Unspecified failure |
|
VC_OLD_WARNING |
10 |
(OLD) Unspecified warning |
|
VC_OLD_OTHER |
2 |
(OLD) Unspecified failure |
|
VC_OLD_RECORD_NOT_FOUND |
1 |
(OLD) Specified record doesn't exist in table |
|
VC_OLD_RECORD_NO_MORE_DATA |
1 |
(OLD) End of filtered table encountered |
|
VC_OLD_RECORD_EXISTS |
1 |
(OLD) Record already exists |
|
VC_OLD_RECORD_DUPLICATE |
1 |
(OLD) Insert has found that the record already exists |
|
VC_OLD_TABLE_EXISTS |
1 |
(OLD) Create has found that the table already exists |
|
Extended Errors |
||
|
VC_GENERAL |
1000 (&H3E8) |
Unspecified failure |
|
VC_RECORD_NOT_FOUND |
1020 (&H3FC) |
Specified record doesn't exist in table |
|
VC_RECORD_NO_MORE_DATA |
1021 (&H3FD) |
End of filtered table encountered |
|
VC_RECORD_EXISTS |
1022 (&H3FE) |
Record already exists |
|
VC_RECORD_DUPLICATE |
1023 (&H3FF) |
Insert has found that the record already exists |
|
VC_RECORD_INVALID |
1024 (&H400) |
Record level validation failed |
|
VC_RECORD_LOCKED |
1025 (&H401) |
Record is locked by another user or task |
|
VC_RECORD_CONFLICT |
1026 (&H402) |
Record updated by another user or task |
|
VC_RECORD_NOT_LOCKED |
1027 (&H403) |
Caller has requested an operation which requires a locked record |
|
VC_TABLE_EXISTS |
1040 (&H410) |
Create has found that the table already exists |
|
VC_TABLE_NOT_FOUND |
1041 (&H411) |
Table that is required by the operation doesn't exist |
|
VC_PERMISSION_NONE |
1060 (&H424) |
User doesn't have security to do this view operation |
|
VC_MEMORY_NO_MORE |
1080 (&H438) |
Out of memory |
|
VC_MEMORY_BUFFER_LIMIT |
1081 (&H439) |
The size of the buffer supplied doesn't meet the operation's required size |
|
VC_FILTER_SYNTAX |
1100 (&H44C) |
Filter's syntax couldn't be parsed |
|
VC_FILTER_OTHER |
1101 (&H44D) |
Unspecified filter error |
|
VC_KEY_INVALID |
1120 (&H460) |
Record's key validation failed |
|
VC_KEY_NUMBER |
1121 (&H461) |
Supplied key number is invalid |
|
VC_KEY_CHANGED |
1122 (&H462) |
Attempt to change alternate key field values but dictionary doesn't permit them to be modified |
|
VC_FIELD_INVALID |
1140 (&H474) |
Field validation failed |
|
VC_FIELD_NUMBER |
1141 (&H475) |
Field number doesn't exist in view |
|
VC_FIELD_INDEX |
1142 (&H476) |
Field index doesn't exist in view |
|
VC_FIELD_DISABLED |
1143 (&H477) |
Attempt to access disabled field |
|
VC_FIELD_READONLY |
1144 (&H478) |
Attempt to change read-only field |
|
VC_TRANSACTION_NONE |
1160 (&H488) |
A transaction is required to do the operation |
|
VC_TRANSACTION_OPEN |
1161 (&H489) |
Transaction couldn't be opened to do the operation |
|
VC_REVISION_PROTOCOL |
1180 (&H49C) |
Invalid revision API state or call |
|
VC_DATABASE_PARAMETER |
1200 (&H4B0) |
Invalid link, table handle, or other parameter to database API |
|
VC_DATABASE_LIMIT |
1201 (&H4B1) |
Database resources exceeded |
|
VC_DATABASE_OTHER |
1202 (&H4B2) |
Unspecified database error |
|
VC_DATABASE_DICTIONARY |
1203 (&H4B3) |
Database dictionary inconsistent |
|
VC_RPC_FAILURE |
1220 (&H4C4) |
Remote procedure call had communication failure |
|
VC_OPERATION_CANCELLED |
2000 (&H7D0) |
The operation was cancelled |
|
VC_NON_VIEW_ERROR |
2001 (&H7D1) |
Non-view error |
|
VC_APPLICATION_DEFINED_BASE |
9000 (&H2328) |
Base (lower limit) for application-defined error codes |
|
VC_APPLICATION_DEFINED_END |
9999 (&H270F) |
End (upper limit) of application-defined error code range |
|
Extended Warnings |
||
|
VC_WARNING |
-1 (&HFFFFFFFF) |
Normal warning |
|
VC_WARNING_GENERAL |
-1 (&HFFFFFFFF) |
Normal warning |
|
VC_WARNING_APPLICATION_DEFINED_BASE |
-1999 (&HFFFFF831) |
Base (lower limit) for application-defined warning codes |
|
VC_WARNING_APPLICATION_DEFINED_END |
-1000 (&HFFFFFC18) |
End (upper limit) of application-defined warning code range |
Remarks
Original view error codes are between 100 and 999. Extended view error codes are between 1000 and 8999. Application-definded error codes are between 9000 (VC_APPLICATION_DEFINED_BASE) and 9999 (VC_APPLICATION_DEFINED_END). The normal view warning code is -1. (The old view warning code is 10.) Application-defined view warning codes are between -1999 (VC_WARNING_APPLICATION_DEFINED_BASE) and -1000 (VC_WARNING_APPLICATION_DEFINED_END). All return codes that are less than 0 are treated as warnings.
Constants that have "OLD" in them are legacy return codes. Views should avoid returning them and use the newer return codes instead.
Individual views may generate return codes that aren't part of this enumeration. (For example, a view may generate an application-defined code that is 9010. You can get that code by testing for VC_APPLICATION_DEFINED_BASE + 10). A view may also generate a return code that matches a constant's value, but its meaning is different than the constant's meaning.