6 Oracle Calendar SDK Status Codes

This chapter documents all CAPIStatus values that may be returned by the SDK functions, in alphabetical order. The functions CSDK_GetStatusString and CSDK_GetStatusLevels may be useful when interpreting CAPIStatus values.

Status Codes

The following codes are defined in the ctapi.h header file.

Table 6-1 Oracle Calendar SDK Status Codes

Status Code	Description
CAPI_STAT_API	API class status.
CAPI_STAT_API_BADPARAM	A bad parameter was passed.
CAPI_STAT_API_CALLBACK	There was a problem with a callback.
CAPI_STAT_API_CALLBACK_ERROR	The callback returned an error, which is returned in bit field 5.
CAPI_STAT_API_FLAGS	Bad flags were passed.
CAPI_STAT_API_HANDLE	There was a problem with a handle.
CAPI_STAT_API_HANDLE_BAD	The passed handle was corrupt.
CAPI_STAT_API_HANDLE_NOTNULL	The passed handle was not null.
CAPI_STAT_API_HANDLE_NULL	The passed handle was null.
CAPI_STAT_API_INCOMPLETE_TRANSACTION	There was a problem with the transaction (probably a store operation) and the data has been stored partially, so the data on the server might be inconsistent with the data the user was trying to store.
CAPI_STAT_API_NULL	A null pointer was passed.
CAPI_STAT_API_POOL	There was a problem with the connection pool.
CAPI_STAT_API_POOL_LOCKFAILED	The connection pool couldn't obtain a lock.
CAPI_STAT_API_POOL_NOCONNECTIONS	The connection pool has no appropriate connections available.
CAPI_STAT_API_POOL_NOTINITIALIZED	The connection pool was not initialized.
CAPI_STAT_API_SESSION	There was a problem with a session.
CAPI_STAT_API_SESSION_BAD	The passed session was corrupt.
CAPI_STAT_API_SESSION_NOTNULL	The passed session was not null.
CAPI_STAT_API_SESSION_NULL	The passed session was null.
CAPI_STAT_API_STREAM	There was a problem with a stream.
CAPI_STAT_API_STREAM_BAD	The passed stream was corrupt.
CAPI_STAT_API_STREAM_NOTNULL	The passed stream was not null.
CAPI_STAT_API_STREAM_NULL	The passed stream was null.
CAPI_STAT_CONFIG	Configuration class status.
CAPI_STAT_CONFIG_CANNOT_OPEN	Failed to open the configuration file passed to CSDK_SetConfigFile.
CAPI_STAT_CONFIG_CANNOT_OPEN_TMPDIRECTORYPATH	Failed to open the tmpDirectoyPath specified in the configuration.
CAPI_STAT_DATA	Data class status.
CAPI_STAT_DATA_COOKIE	Information about the supplied cookie.
CAPI_STAT_DATA_DATE	Information about a date.
CAPI_STAT_DATA_DATE_FORMAT	The format of the date data is incorrect.
CAPI_STAT_DATA_DATE_INVALID	A specified date is invalid (for example, February 30th)
CAPI_STAT_DATA_DATE_NOT_LOCAL	A UTC DTSTART (and/or DTEND) was specified for a recurring event. Must be floating or local.
CAPI_STAT_DATA_DATE_OUTOFRANGE	A specified date is out of the range supported by this implementation.
CAPI_STAT_DATA_DATE_RANGE	The date range is incorrect.
CAPI_STAT_DATA_EMAIL	Information about email.
CAPI_STAT_DATA_EMAIL_NOTSET	No email address is set on the server for one or more users/resources.
CAPI_STAT_DATA_ENCODING	Information about the encoding of supplied data.
CAPI_STAT_DATA_EVENTTYPE	Information about data for the event type is incorrect.
CAPI_STAT_DATA_HOSTNAME	Information about a hostname.
CAPI_STAT_DATA_HOSTNAME_FORMAT	The format of the hostname string was wrong.
CAPI_STAT_DATA_HOSTNAME_HOST	The hostname string could not be resolved to a host.
CAPI_STAT_DATA_HOSTNAME_SERVER	No server could be found on the specified host and port.
CAPI_STAT_DATA_ICAL	Information about iCalendar data.
CAPI_STAT_DATA_ICAL_ATTACH	The operation encountered an error only with the attachment.
CAPI_STAT_DATA_ICAL_ATTACH_INVALID_FILE_URI	The attachment file URI was invalid.
CAPI_STAT_DATA_ICAL_CANTMODIFYRRULE	An attempt was made to modify the recurrence rule for a calendar entry. This is not supported.
CAPI_STAT_DATA_ICAL_COMPEXTRA	An extra component was encountered. Either multiple specifications of a component that should only appear once, or a component that should not appear
CAPI_STAT_DATA_ICAL_COMPMISSING	An expected or required component was missing.
CAPI_STAT_DATA_ICAL_COMPNAME	There was a problem with a component name.
CAPI_STAT_DATA_ICAL_COMPVALUE	There was a problem with what a component contained.
CAPI_STAT_DATA_ICAL_FOLDING	There was a problem in the line folding.
CAPI_STAT_DATA_ICAL_IMPLEMENT	A problem with this particular iCalendar implementation.
CAPI_STAT_DATA_ICAL_INVALIDEXTENSIONDATA	An Oracle iCalendar extension was used incorrectly.
CAPI_STAT_DATA_ICAL_LINEOVERFLOW	One of the iCal data lines was too long, breaching the iCalendar specification (RFC 2445).
CAPI_STAT_DATA_ICAL_MISSING_DTSTART	The iCalendar data given did not contain a DTSTART property required to perform the requested operation.
CAPI_STAT_DATA_ICAL_MISSING_UID	One or more VEVENTs were missing UID properties and an attempt was made to do something other than a CREATE.
CAPI_STAT_DATA_ICAL_MISSINGRECURID	Multiple VEVENTs were supplied with the same UID, and at least two of them did not have a RECURRENCE-ID property.
CAPI_STAT_DATA_ICAL_NOATTENDEES	An attempt was made to store a calendar event without any ATTENDEE properties. This is only supported with the flag CSDK_FLAG_STORE_INVITE_SELF
CAPI_STAT_DATA_ICAL_NONE	The provided data was not iCalendar data.
CAPI_STAT_DATA_ICAL_NOTANATTENDEE	An attempt was made to reply to a calendar event which the user is not attending.
CAPI_STAT_DATA_ICAL_OVERFLOW	There was an overflow when parsing the iCalendar data. This is caused by an internal limitation of the iCalendar library, and not by a breach of the spec
CAPI_STAT_DATA_ICAL_PARAMEXTRA	An extra parameter was encountered. Either multiple specifications of a parameter which should only appear once, or a parameter which should not appear
CAPI_STAT_DATA_ICAL_PARAMMISSING	An expected or required parameter was missing.
CAPI_STAT_DATA_ICAL_PARAMNAME	There was a problem with a parameter name.
CAPI_STAT_DATA_ICAL_PARAMVALUE	There was a problem with a parameter value.
CAPI_STAT_DATA_ICAL_PROPEXTRA	An extra property was encountered. Either multiple specifications of a property which should only appear once, or a property which should not appear
CAPI_STAT_DATA_ICAL_PROPMISSING	An expected or required property was missing.
CAPI_STAT_DATA_ICAL_PROPNAME	There was a problem with a property name.
CAPI_STAT_DATA_ICAL_PROPVALUE	There was a problem with a property value.
CAPI_STAT_DATA_ICAL_RECURMODE	There was a problem with the recurrence specification. The rules laid out in the description of CAPI_StoreEvent were breached
CAPI_STAT_DATA_ICAL_UNKNOWNDATA	The iCalendar data contained unrecognized iCalendar tokens.
CAPI_STAT_DATA_MIME	Information about MIME data.
CAPI_STAT_DATA_MIME_CHARSET	An unsupported character set was specified in a MIME header.
CAPI_STAT_DATA_MIME_COMMENT	A comment could not be parsed.
CAPI_STAT_DATA_MIME_ENCODING	The encoding specified in the MIME object is not supported.
CAPI_STAT_DATA_MIME_HEADER	A header could not be parsed.
CAPI_STAT_DATA_MIME_IMPLEMENT	A restriction specific to this MIME implementation was breached.
CAPI_STAT_DATA_MIME_IMPLEMENT_NESTING	The MIME object was nested too deeply.
CAPI_STAT_DATA_MIME_LENGTH	One of the header lines was too long.
CAPI_STAT_DATA_MIME_NOICAL	No MIME parts were found whose headers indicated that they contain iCalendar data.
CAPI_STAT_DATA_MIME_NONE	No MIME data was found.
CAPI_STAT_DATA_MIME_OVERFLOW	An overflow occurred while reading MIME data.
CAPI_STAT_DATA_QUERY	Information about queries.
CAPI_STAT_DATA_QUERY_CONDITION_ILLEGAL_OPERATOR	A CSDKCondition contained an operator which was not legal for the query being performed.
CAPI_STAT_DATA_QUERY_CONDITION_NULL	A NULL CSDKCondition object was passed into a API function.
CAPI_STAT_DATA_QUERY_CONDITION_PROPERTY_NULL	A CSDKCondition contained a NULL property.
CAPI_STAT_DATA_QUERY_CONDITION_PROPERTY_TOO_LONG	A CSDKCondition contained a property name which was longer than expected.
CAPI_STAT_DATA_QUERY_CONDITION_UNKNOWN_OPERATOR	A CSDKCondition contained an unknown operator.
CAPI_STAT_DATA_QUERY_CONDITION_VALUE_NULL	A CSDKCondition contained a NULL value.
CAPI_STAT_DATA_QUERY_CONDITION_VALUE_TOO_LONG	A CSDKCondition contained a property name which was longer than expected.
CAPI_STAT_DATA_QUERY_ILLEGAL_OPERATOR	An illegal operator was passed to CSDK_AddConditionToQuery. (Only CSDK_LOP_OR and CSDK_LOP_AND are supported.)
CAPI_STAT_DATA_QUERY_NULL	A NULL CSDKQuery object was passed into a API function.
CAPI_STAT_DATA_RRESULT	Information about a request result.
CAPI_STAT_DATA_RRESULT_EOR	No more results were found in the CSDKRequestResult.
CAPI_STAT_DATA_SERVER	Information about data on the server.
CAPI_STAT_DATA_SERVER_TOOMANYATTENDEES	The event has too many attendees for the server to handle.
CAPI_STAT_DATA_SERVER_TOOMANYINSTANCES	The event has too many recurrences for the server to handle.
CAPI_STAT_DATA_UID	Information about a UID.
CAPI_STAT_DATA_UID_ALREADYEXISTS	An object with the specified UID already exists.
CAPI_STAT_DATA_UID_FORMAT	The format of the UID string was wrong.
CAPI_STAT_DATA_UID_MULTIPLEMATCHES	Multiple objects with the specified UID exist.
CAPI_STAT_DATA_UID_NOTFOUND	Data with the supplied UID could not be found.
CAPI_STAT_DATA_UID_RECURRENCE	The specified object could not be found.
CAPI_STAT_DATA_USERID	Information about a userid.
CAPI_STAT_DATA_USERID_EXT	There was a problem with the Extended part of the UserId string.
CAPI_STAT_DATA_USERID_EXT_CONFLICT	Either userid AND X.400 were specified, or both a node and a calendar domain were specified.
CAPI_STAT_DATA_USERID_EXT_FORMAT	The format of the extended string was bad.
CAPI_STAT_DATA_USERID_EXT_INIFILE	There was a problem with the inifile.
CAPI_STAT_DATA_USERID_EXT_MANY	Multiple users were identified by the string.
CAPI_STAT_DATA_USERID_EXT_NODE	The specified node could not be found.
CAPI_STAT_DATA_USERID_EXT_NONE	No users were identified by the string.
CAPI_STAT_DATA_USERID_FORMAT	The format of the UserId string was wrong.
CAPI_STAT_DATA_USERID_ID	There was a problem with the Id part of the UserId string.
CAPI_STAT_DATA_VCARD	Information about vCard data.
CAPI_STAT_DATA_VCARD_COMPNAME	There was a problem with a component name.
CAPI_STAT_DATA_VCARD_DUPERROR	An attempt was made to store a vCard using the mode CSDK_FLAG_STORE_CREATE but a contact with the same UID already existed on the server.
CAPI_STAT_DATA_VCARD_PARAMEXTRA	An extra parameter was encountered. Either multiple specifications of a parameter which should only appear once, or a parameter which should not appear
CAPI_STAT_DATA_VCARD_PARAMMISSING	An expected or required parameter was missing.
CAPI_STAT_DATA_VCARD_PARAMNAME	There was a problem with a parameter name.
CAPI_STAT_DATA_VCARD_PARAMVALUE	There was a problem with a parameter value.
CAPI_STAT_DATA_VCARD_PROPEXTRA	An extra property was encountered. Either multiple specifications of a property which should only appear once, or a property which should not appear
CAPI_STAT_DATA_VCARD_PROPMISSING	An expected or required property was missing.
CAPI_STAT_DATA_VCARD_PROPNAME	There was a problem with a property name.
CAPI_STAT_DATA_VCARD_PROPVALUE	There was a problem with a property value.
CAPI_STAT_DATA_VCARD_PROPVALUE_VIOLATED_SERVERRULE	There was a problem with a property which does not respect a server rule. Example: Suppose dayStart = 9 a.m. and we try to store dayEnd = 8 a.m. This is an error since dayEnd < dayStart.
CAPI_STAT_DATA_VCARD_VERSION_UNSUPPORTED	A vCard with an unrecognized VERSION was encountered.
CAPI_STAT_LIBRARY	Library class status.
CAPI_STAT_LIBRARY_IMPLEMENTATION	The feature is not fully implemented.
CAPI_STAT_LIBRARY_INTERNAL	An internal error occurred in the library.
CAPI_STAT_LIBRARY_INTERNAL_CONTEXT	Invalid context for a dependant library.
CAPI_STAT_LIBRARY_INTERNAL_COSMICRAY	Something completely unexpected happened internally.
CAPI_STAT_LIBRARY_INTERNAL_DATA	There was a corruption of data in the library.
CAPI_STAT_LIBRARY_INTERNAL_EXPIRY	The function has expired in this library.
CAPI_STAT_LIBRARY_INTERNAL_FUNCTION	The library miscalled a function.
CAPI_STAT_LIBRARY_INTERNAL_OVERFLOW	Some internal maximum was exceeded.
CAPI_STAT_LIBRARY_INTERNAL_PROTOCOL	The library abused a protocol.
CAPI_STAT_LIBRARY_INTERNAL_UNKNOWN_EXCEPTION	CAPI received an unknown C++ exception.
CAPI_STAT_LIBRARY_INTERNAL_UNKNOWN_LIBRARY_ERRCODE	Failed to map an error code from a dependant library.
CAPI_STAT_LIBRARY_SERVER	A limitation of or occurrence on the server.
CAPI_STAT_LIBRARY_SERVER_BUSY	The server cannot service the request right now because it is busy.
CAPI_STAT_LIBRARY_SERVER_SUPPORT	The server does not provide support.
CAPI_STAT_LIBRARY_SERVER_SUPPORT_CHARSET	There is no support for the required character set.
CAPI_STAT_LIBRARY_SERVER_SUPPORT_STANDARDS	There is no support for CAPI on this server.
CAPI_STAT_LIBRARY_SERVER_SUPPORT_UID	There is no support for storing UIDs.
CAPI_STAT_LIBRARY_SERVER_TIMEZONE	There was an error dealing with timezones from the Oracle Calendar server.
CAPI_STAT_LIBRARY_SERVER_UNAVAILABLE	The server is running, but unavailable for some reason, e.g. the desired node is down for maintenance
CAPI_STAT_LIBRARY_SERVER_USERDATA	There is some problem with user data on the server.
CAPI_STAT_OK	Operation completed successfully. Value 0
CAPI_STAT_SECUR	Security class status.
CAPI_STAT_SECUR_CANTBOOKATTENDEE	One or more attendees could not be booked. This could be due to lack of access rights, or because the attendee is already booked.
CAPI_STAT_SECUR_INSUFFICIENTRIGHTS	User doesn't have sufficient rights to perform the operation.
CAPI_STAT_SECUR_LOGON	There was a security error on logon.
CAPI_STAT_SECUR_LOGON_AUTH	Logon authentication failed.
CAPI_STAT_SECUR_LOGON_LOCKED	The specified account is locked.
CAPI_STAT_SECUR_LOGON_LOCKED_RESOURCE	Logon is locked for resources.
CAPI_STAT_SECUR_LOGON_LOCKED_SYSOP	Logon is locked for Sysops.
CAPI_STAT_SECUR_READ	There was a security error on read.
CAPI_STAT_SECUR_READ_ALARM	There was a security error reading alarm data.
CAPI_STAT_SECUR_READ_PROPS	There was a security error reading properties.
CAPI_STAT_SECUR_SERVER	There was a security error in the server.
CAPI_STAT_SECUR_SERVER_LICENSE	There was a licensing error on the server.
CAPI_STAT_SECUR_SERVER_SET_IDENTITY_SYSOP	The server requires a SetIdentity call on the sysop logon to perform the operation.
CAPI_STAT_SECUR_SERVER_SET_IDENTITY_SYSOP_REMOTE	Cannot set identity as a remote user while logged in as node sysop.
CAPI_STAT_SECUR_WRITE	There was a security error on write.
CAPI_STAT_SECUR_WRITE_AGENDA	There was a security error writing to an agenda.
CAPI_STAT_SECUR_WRITE_EVENT	There was a security error writing to an event.
CAPI_STAT_SERVICE	Service class status.
CAPI_STAT_SERVICE_ACE	There was a problem caused by one of the ACE plug-ins.
CAPI_STAT_SERVICE_ACE_LOAD	Required ACE plug-in could not be loaded.
CAPI_STAT_SERVICE_ACE_SUPPORT	Requested ACE option not supported.
CAPI_STAT_SERVICE_FILE	There was a problem with system file services.
CAPI_STAT_SERVICE_FILE_CLOSE	There was a problem closing a file.
CAPI_STAT_SERVICE_FILE_DELETE	There was a problem deleting a file.
CAPI_STAT_SERVICE_FILE_MODE	There was a problem with the read or write mode for a file.
CAPI_STAT_SERVICE_FILE_OPEN	There was a problem opening a file.
CAPI_STAT_SERVICE_FILE_READ	There was a problem reading from a file.
CAPI_STAT_SERVICE_FILE_TEMP	There was a problem allocating a temporary file.
CAPI_STAT_SERVICE_FILE_WRITE	There was a problem writing to a file.
CAPI_STAT_SERVICE_LIBRARY	There was a problem with the standard library services.
CAPI_STAT_SERVICE_MEM	There was a problem with system memory services.
CAPI_STAT_SERVICE_MEM_ALLOC	Could not allocate memory.
CAPI_STAT_SERVICE_NET	There was a problem with network services.
CAPI_STAT_SERVICE_NET_TIMEOUT	Timeout while waiting for network services.
CAPI_STAT_SERVICE_THREAD	There was a problem with system thread services.
CAPI_STAT_SERVICE_TIME	There was a problem with the standard time services.
CAPI_STAT_SERVICE_TIME_GMTIME	GMTime could not be obtained.