(Page 1 of 1 in this chapter) Version

Appendix B

NCC Service Errors

This appendix provides a summary of error codes that may be returned as a direct result of an NCC service function invocation. Included are both CT Access error codes and NCC service error codes.
The error codes are presented in two tables: Alphabetically by error code name, including a description of the problem and a possible solution. Numerically by hex number, decimal number, and error name.
All CT Access service functions return a status code. If the return code is not SUCCESS (0), it is an error code indicating that the function has failed and the reason for the failure.
CT Access error codes are defined in the include file ctaerr.h. The error codes are prefixed with CTAERR. NCC service error codes are defined in the include file nccerr.h. The error codes are prefixed with NCCERR.

Error Name	Hex	Decimal	Description
CTAERR_BAD_ARGUMENT	0x7	7	Problem: A function argument had an invalid value, or a required pointer argument was NULL. Solution: Check all arguments for valid types and ranges.
CTAERR_BAD_SIZE	0xB	11	Problem: A *size* argument was too small to receive a data structure, or a play or record buffer was not a multiple of the frame size for the specified encoding. Solution: Check all arguments for valid sizes.
CTAERR_INVALID_CTAHD	0x5	5	An invalid CTA context handle was passed as an argument to a function, or the context was destroyed by another thread.
CTAERR_INVALID_HANDLE	0x20	32	An invalid handle was passed as an argument to this function.
CTAERR_INVALID_STATE	0xC	12	This function is not valid in the current line state.
NCCERR_NOT_CAPABLE	0x001C0001	1835009	Problem: A function or parameter is not supported by the current protocol. Solution: nccQueryCapability can be used to determine features supported by the protocol.
NCCERR_INVALID_CALL_STATE	0x001C0002	1835010	This function is not valid in the current call state.

The following table is a numerically ordered list of errors that may occur as a direct result of an NCC service function call: Hex Decimal Error Name 0x5 5 CTAERR_INVALID_CTAHD 0x7 7 CTAERR_BAD_ARGUMENT 0xB 11 CTAERR_BAD_SIZE 0xC 12 CTAERR_INVALID_STATE 0x20 32 CTAERR_INVALID_HANDLE 0x001C0001 1835009 NCCERR_NOT_CAPABLE 0x001C0002 1835010 NCCERR_INVALID_CALL_STATE

(Page 1 of 1 in this chapter) Version