NAME
SETREF Return Values
DESCRIPTION
SETREF functions return numeric return values to indicate success or failure. Success is indicated with NO_ERROR, but failure results are indicated using a specially formatted numeric return value that contains, at a minimum, a module indicator and a module-specific failure value. Two macros, ERROR_MODULE() and ERROR_NUMBER() convert between a numeric return value and values representing the module that generated the error and the module-specific error number.

For documentation on displaying or logging return values, see error_ctx.

RETURN VALUES
SETREF functions return either NO_ERROR to indicate success, or one of the following failure codes to indicate a specific failure.

a2c
A2C_ERR_BAD_CHOSEN
bad chosen value
A2C_ERR_BAD_INDEX
unknown error
A2C_ERR_BAD_PARAMETER
bad parameter passed to function
A2C_ERR_BAD_PARAMETERS
unknown error
A2C_ERR_BAD_SELECTOR
unknown error
A2C_ERR_ENCODING
encoding error
A2C_ERR_IO
unknown error
A2C_ERR_NOTHING_CHOSEN
nothing chosen
A2C_ERR_UNKNOWN_MODIFY
unknown error
A2C_ERR_UNKNOWN_QUERY
unknown error
A2C_ERR_USER_DATA
unknown error
A2C_ERR_VALUE_MISSING
value missing but not optional
store
CACHE_CTX_WARN_NO_STATE
The requested state was not in the cache
certs
CERTS_ERR_BAD_CERTIFICATE
CERTS_ERR_BAD_CERTIFICATE
CERTS_ERR_NO_CERTIFICATE
CERTS_ERR_NO_CERTIFICATE
kdb
KDB_ERR_NOT_FOUND
KDB_ERR_NOT_FOUND
store
LOG_CTX_WARN_NO_LOG_ENTRY
The requested entry was not in the log
ops
OPS_ERR_BAD_CERT_TYPE
OPS_ERR_BAD_CERT_TYPE
OPS_ERR_BAD_DN
OPS_ERR_BAD_DN
OPS_ERR_BAD_ENCODING
OPS_ERR_BAD_ENCODING
OPS_ERR_BAD_EXT_CRITICALITY
OPS_ERR_BAD_EXT_CRITICALITY
OPS_ERR_BAD_KEY_USE
OPS_ERR_BAD_KEY_USE
OPS_ERR_BAD_OAEP_ENCODING
OPS_ERR_BAD_OAEP_ENCODING
OPS_ERR_BAD_PARAMETER
OPS_ERR_BAD_PARAMETER
OPS_ERR_BC
OPS_ERR_BC
OPS_ERR_CERT_CHAIN_TOO_LONG
OPS_ERR_CERT_CHAIN_TOO_LONG
OPS_ERR_CERT_CHAIN_TOO_SHORT
OPS_ERR_CERT_CHAIN_TOO_SHORT
OPS_ERR_DATA_LENGTH
OPS_ERR_DATA_LENGTH
OPS_ERR_DECODING_DATA
OPS_ERR_DECODING_DATA
OPS_ERR_DEK_LENGTH
OPS_ERR_DEK_LENGTH
OPS_ERR_DUPLICATE_EXTENSION
OPS_ERR_DUPLICATE_EXTENSION
OPS_ERR_ENCODING_DATA
OPS_ERR_ENCODING_DATA
OPS_ERR_EXT_CERTIFICATE_TYPE
OPS_ERR_EXT_CERTIFICATE_TYPE
OPS_ERR_EXT_KEY_USAGE
OPS_ERR_EXT_KEY_USAGE
OPS_ERR_HASH_VERIFICATION
OPS_ERR_HASH_VERIFICATION
OPS_ERR_HD_ABSENT_IN_OAEP
OPS_ERR_HD_ABSENT_IN_OAEP
OPS_ERR_HD_LENGTH
OPS_ERR_HD_LENGTH
OPS_ERR_HD_PRESENT_IN_OAEP
OPS_ERR_HD_PRESENT_IN_OAEP
OPS_ERR_ILLEGAL_EXTENSION
OPS_ERR_ILLEGAL_EXTENSION
OPS_ERR_INCORRECT_CRYPTO
OPS_ERR_INCORRECT_CRYPTO
OPS_ERR_INCORRECT_EXTENSION_DATA
OPS_ERR_INCORRECT_EXTENSION_DATA
OPS_ERR_INTERNAL
OPS_ERR_INTERNAL
OPS_ERR_MEMORY
OPS_ERR_MEMORY
OPS_ERR_MISSING_EXTENSION
OPS_ERR_MISSING_EXTENSION
OPS_ERR_MISSING_EXTENSION_DATA
OPS_ERR_MISSING_EXTENSION_DATA
OPS_ERR_UNKNOWN_CRITICAL_EXTENSION
OPS_ERR_UNKNOWN_CRITICAL_EXTENSION
OPS_ERR_UNKNOWN_EXTENSION
OPS_ERR_UNKNOWN_EXTENSION
OPS_ERR_UNKNOWN_MODIFY
OPS_ERR_UNKNOWN_MODIFY
OPS_ERR_UNKNOWN_QUERY
OPS_ERR_UNKNOWN_QUERY
OPS_ERR_WRONG_OPS_IDENTITY_CHOICE
OPS_ERR_WRONG_OPS_IDENTITY_CHOICE
OPS_ERR_X_ABSENT_IN_OAEP
OPS_ERR_X_ABSENT_IN_OAEP
OPS_ERR_X_PRESENT_IN_OAEP
OPS_ERR_X_PRESENT_IN_OAEP
OPS_ERR_X_UNAVAILABLE
OPS_ERR_X_UNAVAILABLE
OPS_ERR_X_UNUSED
OPS_ERR_X_UNUSED
pkcs7
PKCS7_ERR_BAD_DATA
PKCS7_ERR_BAD_DATA
PKCS7_ERR_CONTENT_MISSING
PKCS7_ERR_CONTENT_MISSING
PKCS7_ERR_CONTENT_PRESENT
PKCS7_ERR_CONTENT_PRESENT
PKCS7_ERR_HASH_VERIFICATION
PKCS7_ERR_HASH_VERIFICATION
PKCS7_ERR_INTERNAL
PKCS7_ERR_INTERNAL
PKCS7_ERR_IO
PKCS7_ERR_IO
PKCS7_ERR_KEY_NOT_FOUND
PKCS7_ERR_KEY_NOT_FOUND
PKCS7_ERR_NO_MEMORY
PKCS7_ERR_NO_MEMORY
PKCS7_ERR_NO_OAEP
PKCS7_ERR_NO_OAEP
PKCS7_ERR_NO_SIGNATURE
PKCS7_ERR_NO_SIGNATURE
PKCS7_ERR_NULL_POINTER
unknown error
PKCS7_ERR_OAEP_EXISTS
PKCS7_ERR_OAEP_EXISTS
PKCS7_ERR_TOO_MANY_SIGNATURES
PKCS7_ERR_TOO_MANY_SIGNATURES
PKCS7_ERR_WRONG_PROCESS
PKCS7_ERR_WRONG_PROCESS
PKCS7_ERR_WRONG_VERSION
PKCS7_ERR_WRONG_VERSION
set_msg
SET_ERR_ALTERED_MSG_TYPE
SET_ERR_ALTERED_MSG_TYPE
SET_ERR_BAD_INBAND_KEY
SET_ERR_BAD_INBAND_KEY
SET_ERR_BAD_MSG_ORDER
SET_ERR_BAD_MSG_ORDER
SET_ERR_BAD_MSG_TYPE
SET_ERR_BAD_MSG_TYPE
SET_ERR_BAD_PARAMETER
SET_ERR_BAD_PARAMETER
SET_ERR_DECODING
SET_ERR_DECODING
SET_ERR_DURING_CERT_DB_INIT
SET_ERR_DURING_CERT_DB_INIT
SET_ERR_ENCODING
SET_ERR_ENCODING
SET_ERR_ILLEGAL_CAPTOKEN
SET_ERR_ILLEGAL_CAPTOKEN
SET_ERR_ILLEGAL_ENTITY
SET_ERR_ILLEGAL_ENTITY
SET_ERR_ILLEGAL_NULL_CAPTOKEN
SET_ERR_ILLEGAL_NULL_CAPTOKEN
SET_ERR_ILLEGAL_PANDATA0
SET_ERR_ILLEGAL_PANDATA0
SET_ERR_ILLEGAL_PI_REPLAY
SET_ERR_ILLEGAL_PI_REPLAY
SET_ERR_ILLEGAL_PREVAUTHDATETIME
SET_ERR_ILLEGAL_PREVAUTHDATETIME
SET_ERR_ILLEGAL_RECURRINGCOUNT
SET_ERR_ILLEGAL_RECURRINGCOUNT
SET_ERR_ILLEGAL_REGFORMORREFERRAL
SET_ERR_ILLEGAL_REGFORMORREFERRAL
SET_ERR_ILLEGAL_REQUESTTYPE
SET_ERR_ILLEGAL_REQUESTTYPE
SET_ERR_INCOMPATIBLE_INBAND_ALGS
SET_ERR_INCOMPATIBLE_INBAND_ALGS
SET_ERR_INTERNAL
SET_ERR_INTERNAL
SET_ERR_MAX_SIZE_BATCH_CAPTURE
SET_ERR_MAX_SIZE_BATCH_CAPTURE
SET_ERR_MAX_SIZE_CLOCK_SKEW
SET_ERR_MAX_SIZE_CLOCK_SKEW
SET_ERR_MAX_SIZE_RECURRINGEXPIRY
SET_ERR_MAX_SIZE_RECURRINGEXPIRY
SET_ERR_MAX_SIZE_RECURRINGFREQUENCY
SET_ERR_MAX_SIZE_RECURRINGFREQUENCY
SET_ERR_MAX_SIZE_RECURRING_AGE
SET_ERR_MAX_SIZE_RECURRING_AGE
SET_ERR_MEMORY
SET_ERR_MEMORY
SET_ERR_MISSING_STATE
SET_ERR_MISSING_STATE
SET_ERR_MSG_NOT_CREATED
SET_ERR_MSG_NOT_CREATED
SET_ERR_MSG_NOT_DECODED
SET_ERR_MSG_NOT_DECODED
SET_ERR_MSG_NOT_PREPARED
SET_ERR_MSG_NOT_PREPARED
SET_ERR_MSG_NOT_RECEIVED
SET_ERR_MSG_NOT_RECEIVED
SET_ERR_MSG_NOT_VERIFIED
SET_ERR_MSG_NOT_VERIFIED
SET_ERR_MSG_TYPE_MSG_ID_MISMATCH
SET_ERR_MSG_TYPE_MSG_ID_MISMATCH
SET_ERR_NO_ACCTDATA
SET_ERR_NO_ACCTDATA
SET_ERR_NO_ACQBACKINFO
SET_ERR_NO_ACQBACKINFO
SET_ERR_NO_AI_PARAMETER
SET_ERR_NO_AI_PARAMETER
SET_ERR_NO_CARDHOLDER_ID
SET_ERR_NO_CARDHOLDER_ID
SET_ERR_NO_CERTRESDATA_CERTIFICATE
SET_ERR_NO_CERTRESDATA_CERTIFICATE
SET_ERR_NO_CERTTHUMBS
SET_ERR_NO_CERTTHUMBS
SET_ERR_NO_CHECKDIGESTS
SET_ERR_NO_CHECKDIGESTS
SET_ERR_NO_EEMESSAGE
SET_ERR_NO_EEMESSAGE
SET_ERR_NO_EEPRIVATEKEYINFO
SET_ERR_NO_EEPRIVATEKEYINFO
SET_ERR_NO_EESIGNATUREDN
SET_ERR_NO_EESIGNATUREDN
SET_ERR_NO_ERROR_TO_ERROR
SET_ERR_NO_ERROR_TO_ERROR
SET_ERR_NO_ERROR_TO_RESPONSE
SET_ERR_NO_ERROR_TO_RESPONSE
SET_ERR_NO_GATEWAYKEYEXCHANGEDN
SET_ERR_NO_GATEWAYKEYEXCHANGEDN
SET_ERR_NO_LOCAL_INBAND_SUPPORT
SET_ERR_NO_LOCAL_INBAND_SUPPORT
SET_ERR_NO_MATCHING_PUBLIC_KEY
SET_ERR_NO_MATCHING_PUBLIC_KEY
SET_ERR_NO_NEW_CERTIFICATE
SET_ERR_NO_NEW_CERTIFICATE
SET_ERR_NO_NONCECCA
SET_ERR_NO_NONCECCA
SET_ERR_NO_PANDATA0
SET_ERR_NO_PANDATA0
SET_ERR_NO_PREVAUTHDATETIME
SET_ERR_NO_PREVAUTHDATETIME
SET_ERR_NO_PUBLIC_KEY_E
SET_ERR_NO_PUBLIC_KEY_E
SET_ERR_NO_PUBLIC_KEY_S
SET_ERR_NO_PUBLIC_KEY_S
SET_ERR_NO_RECURRINGCOUNT
SET_ERR_NO_RECURRINGCOUNT
SET_ERR_NO_REMOTE_INBAND_SUPPORT
SET_ERR_NO_REMOTE_INBAND_SUPPORT
SET_ERR_NO_SPLITRECURIND
SET_ERR_NO_SPLITRECURIND
SET_ERR_NO_SUBSEQUENTAUTHIND
SET_ERR_NO_SUBSEQUENTAUTHIND
SET_ERR_NO_THUMBS
SET_ERR_NO_THUMBS
SET_ERR_PACKET_MISSING_DATA
SET_ERR_PACKET_MISSING_DATA
SET_ERR_UNEXPECTED_ACQCARDCODEMSG
SET_ERR_UNEXPECTED_ACQCARDCODEMSG
SET_ERR_UNEXPECTED_CABACKKEYALG
SET_ERR_UNEXPECTED_CABACKKEYALG
SET_ERR_UNEXPECTED_RRPID
SET_ERR_UNEXPECTED_RRPID
SET_ERR_UNKNOWN_MODIFY
SET_ERR_UNKNOWN_MODIFY
SET_ERR_UNKNOWN_QUERY
SET_ERR_UNKNOWN_QUERY
SET_ERR_WRONG_ACQUIRER_BIN
SET_ERR_WRONG_ACQUIRER_BIN
SET_ERR_WRONG_CARDHOLDER_ID
SET_ERR_WRONG_CARDHOLDER_ID
SET_ERR_WRONG_CHALLENGE
SET_ERR_WRONG_CHALLENGE
SET_ERR_WRONG_HASH_OF_OD
SET_ERR_WRONG_HASH_OF_OD
SET_ERR_WRONG_MERCHANT_ID
SET_ERR_WRONG_MERCHANT_ID
SET_ERR_WRONG_MESSAGEWRAPPER
SET_ERR_WRONG_MESSAGEWRAPPER
SET_ERR_WRONG_NEW_CERT_DN
SET_ERR_WRONG_NEW_CERT_DN
SET_ERR_WRONG_RRPID
SET_ERR_WRONG_RRPID
SET_ERR_WRONG_THUMBS
SET_ERR_WRONG_THUMBS
SET_ERR_WRONG_TRANSIDS
SET_ERR_WRONG_TRANSIDS
SET_ERR_WRONG_VERSION
SET_ERR_WRONG_VERSION
SET_ERR_WRONG_XID
SET_ERR_WRONG_XID
SET_WARN_AUTHTOKEN_EXPIRED
SET_WARN_AUTHTOKEN_EXPIRED
SET_WARN_RRPID_REPLAY
SET_WARN_ILLEGAL_REPLAY
error
SE_ERR_BAD_BER_DER_ENCODING
SE_ERR_BAD_BER_DER_ENCODING
SE_ERR_FATAL_IO
SE_ERR_FATAL_IO
SE_ERR_ILLEGAL_ARG
One of the parameters passed in as an argument is invalid
SE_ERR_ILLEGAL_NULL_ARG
One of the parameters passed in as an argument is invalid because of a null pointer
SE_ERR_INTERNAL
An internal program inconsistency was encountered, generally because of a programming bug
SE_ERR_NO_MEMORY
A memory error occurred, generally because an attempt to allocate more memory has failed
SE_WARN_OPERATION_CANCELLED
SE_WARN_OPERATION_CANCELLED
store
STORE_ERR_LENMAX_TOO_SMALL
STORE_ERR_LENMAX_TOO_SMALL
STORE_ERR_MEMORY_OVERFLOW
STORE_ERR_MEMORY_OVERFLOW
STORE_ERR_TOO_LONG
STORE_ERR_TOO_LONG
STORE_WARN_NOT_FOUND
STORE_WARN_NOT_FOUND
BUGS
This document describes a beta implementation. The information contained in this document may be incomplete and is subject to change.

Copyright © 1996, 1997, Visa International Service Association and MasterCard International Incorporated
All Rights Reserved.