Return Codes

The following are possible return values for LEADTOOLS DICOM functions. These are the values in the ltdicErrors.h file.

Value

Number

Description

DICOM_ERROR_ISCL_OK

0

Operation is successful.

DICOM_ERROR_TLS_OK

0

Operation is successful.

DICOM_SUCCESS

0

Operation is successful.

DICOM_ERROR_LOCKED

1

DICOM support is locked. You must unlock the Medical Support.

DICOM_ERROR_MEMORY

2

Insufficient memory.

DICOM_ERROR_OPEN

3

Error opening the file.

DICOM_ERROR_READ

4

Error reading the file.

DICOM_ERROR_WRITE

5

Error writing to a file.

DICOM_ERROR_SEEK

6

Error during search.

DICOM_ERROR_END

7

Error - end of file.

DICOM_ERROR_FORMAT

8

Improper file format.

DICOM_ERROR_PARAMETER

9

Incorrect parameter.

DICOM_ERROR_IMAGE

10

Improper image.

DICOM_ERROR_COMPRESSION

11

Improper compression.

DICOM_ERROR_PHOTOMETRIC

12

Improper photometric type.

DICOM_ERROR_CONVERSION

13

Error converting the file.

DICOM_ERROR_RANGE

14

Out of range.

DICOM_ERROR_BITSPERPIXEL

15

Improper bits per pixel.

DICOM_ERROR_QFACTOR

16

Improper quality factor.

DICOM_ERROR_PDU_TYPE

17

Improper PDU type.

DICOM_ERROR_PDU_LENGTH

18

Improper PDU length.

DICOM_ERROR_PDU_ID

19

Improper PDU ID.

DICOM_ERROR_NET_FAILURE

29

Network failure.

DICOM_ERROR_NET_ACCESS

30

The address is a broadcast address.

DICOM_ERROR_NET_ADDRESS_IN_USE

31

The address is already in use.

DICOM_ERROR_NET_ADDRESS_NOT_AVAILABLE

32

The address is not available from the local computer.

DICOM_ERROR_NET_ADDRESS_NOT_SUPPORTED

33

The address family is not supported.

DICOM_ERROR_NET_CONNECTION_ABORTED

34

The virtual circuit was aborted.

DICOM_ERROR_NET_CONNECTION_REFUSED

35

The attempt to connect was forcefully rejected.

DICOM_ERROR_NET_CONNECTION_RESET

36

The virtual circuit was reset by the remote side.

DICOM_ERROR_NET_DESTINATION_REQUIRED

37

A destination address is required.

DICOM_ERROR_NET_ARGUMENT_INCORRECT

38

The namelen argument is incorrect.

DICOM_ERROR_NET_IN_PROGRESS

39

A blocking operation is in progress.

DICOM_ERROR_NET_BLOCKING_CANCELED

40

The blocking call was canceled.

DICOM_ERROR_NET_INVALID

41

The socket has not been bound with bind.

DICOM_ERROR_NET_IS_CONNECTED

42

The socket is already connected.

DICOM_ERROR_NET_NO_MORE_FILE

43

No more file descriptors are available.

DICOM_ERROR_NET_MESSAGE_SIZE

44

The datagram is larger than the maximum supported.

DICOM_ERROR_NET_DOWN

45

The network subsystem has failed.

DICOM_ERROR_NET_RESET

46

The connection must be reset.

DICOM_ERROR_NET_UN_REACH

47

The network can't be reached from this host at this time.

DICOM_ERROR_NET_NO_BUFFERS

48

No buffer space is available.

DICOM_ERROR_NET_NOT_CONNECTED

49

The socket is not connected.

DICOM_ERROR_NET_NOT_SOCKET

50

The descriptor is not a socket.

DICOM_ERROR_NET_OPERATION_NOT_SUPPORTED

51

The type does not support connection-oriented service.

DICOM_ERROR_NET_PROTOCOL_NOT_SUPPORTED

52

The specified protocol is not supported.

DICOM_ERROR_NET_PROTOCOL_TYPE

53

The specified protocol is the wrong type.

DICOM_ERROR_NET_SHUTDOWN

54

The socket has been shut down.

DICOM_ERROR_NET_SOCKET_NOT_SUPPORTED

55

The type is not supported in this address family.

DICOM_ERROR_NET_TIME_OUT

56

Attempt to connect timed out without establishing a connection.

DICOM_ERROR_NET_WOULD_BLOCK

57

The socket is marked as nonblocking and the requested operation would block.

DICOM_ERROR_NET_HOST_NOT_FOUND

58

Authoritative Answer Host not found.

DICOM_ERROR_NET_NO_DATA

59

Valid name, no data record of requested type.

DICOM_ERROR_NET_NO_RECOVERY

60

Nonrecoverable errors.

DICOM_ERROR_NET_NOT_INITIALISED

61

The system was not initialized.

DICOM_ERROR_NET_SYSTEM_NOT_READY

62

Not ready for network communication.

DICOM_ERROR_NET_TRY_AGAIN

63

Non-Authoritative Host not found, or server faild.

DICOM_ERROR_NET_VERSION_NOT_SUPPORTED

64

The version requested is not provided by this implementation.

DICOM_ERROR_NET_SECURITY_BREACH

65

There is an cryptographic error.

DICOM_ERROR_TLS

66

TLS internal error.

DICOM_ERROR_SECURITY_LOCKED

67

DICOM Security Features are locked.

DICOM_ERROR_TLS_DLL_NOT_LOADED

68

TLS and/or CRY DLL not loaded.

DICOM_ERROR_BAD_SECURE_MODE

69

ISCL operation attempted on TLS object.

DICOM_ERROR_ANN

70

Annotation error.

DICOM_ERROR_ANN_LOCKED

71

Annotation support is locked.

DICOM_ERROR_ANN_MISSING

72

Annotation dll is missing.

DICOM_ERROR_TAG_ALREADY_EXISTS

73

LEAD private creator element already exists.

DICOM_ERROR_ANN_NO_EXIST

74

Requested annotation file or page does not exist.

DICOM_ERROR_ELEMENT_LENGTH_ODD

100

Option not expected or unknown. This contant is redundant and remains for backward compatibilty.

DICOM_ERROR_ISCL_BAD_OPTION

100

Option not expected or unknown.

DICOM_ERROR_ISCL_BAD_LENGTH

101

The length of the message differ of the expected length.

DICOM_ERROR_ISCL_LOCAL_ICCARD

102

Local error on Id card.

DICOM_ERROR_ISCL_REMOTE_ICCARD

103

Error on Id card level at peer.

DICOM_ERROR_ISCL_BAD_MSGID

104

Message id not expected or unknown.

DICOM_ERROR_ISCL_BAD_VERSION

105

Bad version number - not MEDIS-ISCL V1.00.

DICOM_ERROR_ISCL_BAD_MUTUAL_AUTH_METHOD

106

Bad mutual authentication mode - mutual auth not 3pass 4way.

DICOM_ERROR_ISCL_BAD_COMMBLOCK_LENGTH

107

Bad communication block length - the comm block length is too big.

DICOM_ERROR_ISCL_RECEIVED_NAK

108

Received a 'Not Acknowledged' message - when the peer sent option = NAK in general cases, there are some special cases.

DICOM_ERROR_ISCL_MSG_TRANSMISSION

109

Bad encryption method or MAC method.

DICOM_ERROR_ISCL_PEER_SMALL_LENGTH

110

Message length of the peer is too small.

DICOM_ERROR_ISCL_LOCAL_SMALL_LENGTH

111

Peer want to send a message bigger than local MaxMessageLength.

DICOM_ERROR_ISCL_DECRYPT

112

Error during decryption - decryption generate bad result.

DICOM_ERROR_ISCL_BAD_MAC

113

Wrong message authentication code.

DICOM_ERROR_ISCL_RND_NO_FOR_SESSION_KEY_EXPECTED

114

Only when the receiver expect to receive a "Random number for session key" request. The sender must be set to "SetSecurity(DICOM_ISCL_UNIQUE_SESSION_KEYS)".

DICOM_ERROR_ISCL_PEER_REFUSE_CLOSE

115

When the peer does not accept the closing of connection.

DICOM_ERROR_TLS_CLOSE_NOTIFY

128

Error in close notification.

DICOM_ERROR_TLS_UNEXPECTED_MESSAGE

129

Unexpected message.

DICOM_ERROR_TLS_BAD_RECORD_MAC

130

Bad record message authentication code.

DICOM_ERROR_TLS_DECRYPT_FAILED

131

Decryption failed.

DICOM_ERROR_TLS_RECORD_OVERFLOW

132

Record overflow.

DICOM_ERROR_TLS_DECOMPRESSION_FAILURE

133

Decompression failed.

DICOM_ERROR_TLS_HANDSHAKE_FAILURE

134

Handshake failed.

DICOM_ERROR_TLS_BAD_CERTIFICATE

135

Bad certificate.

DICOM_ERROR_TLS_UNSUPPORTED_CERTIFICATE

136

Unsupported certificate.

DICOM_ERROR_TLS_CERTIFICATE_REVOKED

137

Certificate revoked.

DICOM_ERROR_TLS_CERTIFICATE_EXPIRED

138

Certificate Expired.

DICOM_ERROR_TLS_CERTIFICATE_UNKNOWN

139

Certificate unknown.

DICOM_ERROR_TLS_ILLEGAL_PARAMETER

140

Illegal parameter.

DICOM_ERROR_TLS_UNKNOWN_CA

141

Unknown certificate authenticator.

DICOM_ERROR_TLS_ACCESS_DENIED

142

Access denied.

DICOM_ERROR_TLS_DECODE_ERROR

143

Error decoding.

DICOM_ERROR_TLS_DECRYPT_ERROR

144

Decryption error.

DICOM_ERROR_TLS_EXPORT_RESTRICTION

145

Export restriction.

DICOM_ERROR_TLS_PROTOCOL_VERSION

146

Wrong protocol version.

DICOM_ERROR_TLS_INSUFFICIENT_SECURITY

147

Insufficient security.

DICOM_ERROR_TLS_INTERNAL_ERROR

148

Internal error Call LEAD.

DICOM_ERROR_TLS_USER_CANCELED

149

User cancelled.

DICOM_ERROR_TLS_NO_RENEGOTIATION

150

No renegotiation.

DICOM_ERROR_TLS_NO_KEEPALIVE

151

Windows Sockets provider" does not support the use of keep-alives.

DICOM_ERROR_TLS_CLOSED_CONTROLLED

152

An error occurred and the connection was closed gracefully.

DICOM_ERROR_TLS_UNABLE_TO_GET_ISSUER_CERT

160

Unable to get issuer certificate.

DICOM_ERROR_TLS_UNABLE_TO_GET_CRL

161

Unable to get CRL.

DICOM_ERROR_TLS_UNABLE_TO_DECRYPT_CERT_SIGNATURE

162

Unable to decrypt certificate signature.

DICOM_ERROR_TLS_UNABLE_TO_DECRYPT_CRL_SIGNATURE

163

Unable to decrypt CRL signature.

DICOM_ERROR_TLS_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY

164

Unable to decode issuer public key.

DICOM_ERROR_TLS_CERT_SIGNATURE_FAILURE

165

Certificate signature failure.

DICOM_ERROR_TLS_CRL_SIGNATURE_FAILURE

166

Error TLS CRL Signature Failure.

DICOM_ERROR_TLS_CERT_NOT_YET_VALID

167

Error TLS Certificate Not Yet Valid.

DICOM_ERROR_TLS_CERT_HAS_EXPIRED

168

Error TLS Certificate Has Expired.

DICOM_ERROR_TLS_CRL_NOT_YET_VALID

169

Error TLS CRL Not Yet Valid.

DICOM_ERROR_TLS_CRL_HAS_EXPIRED

170

Error TLS CRL Has Expired.

DICOM_ERROR_TLS_ERROR_IN_CERT_NOT_BEFORE_FIELD

171

Error TLS Error In Certificate Not Before Field.

DICOM_ERROR_TLS_ERROR_IN_CERT_NOT_AFTER_FIELD

172

Error TLS Error In Certificate Not After Field.

DICOM_ERROR_TLS_ERROR_IN_CRL_LAST_UPDATE_FIELD

173

Error TLS Error In CRL Last Update Field.

DICOM_ERROR_TLS_ERROR_IN_CRL_NEXT_UPDATE_FIELD

174

Error TLS Error In CRL Next Update Field.

DICOM_ERROR_TLS_OUT_OF_MEM

175

Error TLS Out Of Memory.

DICOM_ERROR_TLS_DEPTH_ZERO_SELF_SIGNED_CERT

176

Error TLS Depth Zero Self Signed Certificate.

DICOM_ERROR_TLS_SELF_SIGNED_CERT_IN_CHAIN

177

Error TLS Self Signed Certificate In Chain.

DICOM_ERROR_TLS_UNABLE_TO_GET_ISSUER_CERT_LOCALLY

178

Error TLS Unable To Get Issuer Certificate Locally.

DICOM_ERROR_TLS_UNABLE_TO_VERIFY_LEAF_SIGNATURE

179

Error TLS Unable To Verify Leaf Signature.

DICOM_ERROR_TLS_CERT_CHAIN_TOO_LONG

180

Error TLS Certificate Chain Too Long.

DICOM_ERROR_TLS_CERT_REVOKED

181

Error TLS Certificate Revoked.

DICOM_ERROR_TLS_INVALID_CA

182

Error TLS Invalid CA.

DICOM_ERROR_TLS_PATH_LENGTH_EXCEEDED

183

Error TLS Path Length Exceeded.

DICOM_ERROR_TLS_INVALID_PURPOSE

184

Error TLS Invalid Purpose.

DICOM_ERROR_TLS_CERT_UNTRUSTED

185

Error TLS Certificate Untrusted.

DICOM_ERROR_TLS_CERT_REJECTED

186

Error TLS Certificate Rejected.

DICOM_ERROR_TLS_SUBJECT_ISSUER_MISMATCH

187

Error TLS Subject Issuer Mismatch.

DICOM_ERROR_TLS_AKID_SKID_MISMATCH

188

Error TLS AKID SKID Mismatch.

DICOM_ERROR_TLS_AKID_ISSUER_SERIAL_MISMATCH

189

Error TLS AKID Issuer Serial Mismatch.

DICOM_ERROR_TLS_KEYUSAGE_NO_CERTSIGN

190

Error TLS Keyusage No Certsign.

DICOM_ERROR_TLS_APPLICATION_VERIFICATION

191

Error TLS Application Verification.

DICOM_ERROR_TLS_INVALID_CTX

192

Error TLS Invalid SSL Context.

DICOM_ERROR_TLS_INVALID_CTX_VERIFY_DEPTH

193

Error TLS Invalid SSL Context Verify Depth.

DICOM_ERROR_TLS_INVALID_CTX_VERIFY_MODE

194

Error TLS Invalid SSL Context Verify Mode.

DICOM_ERROR_TLS_INVALID_CTX_CAFILE

195

Error TLS Invalid SSL Context CA File.

DICOM_ERROR_TLS_INVALID_CTX_OPTIONS

196

Error TLS Invalid SSL Context Options.

DICOM_ERROR_DICOMDIR_FOLDER

200

The destination folder of the DICOMDIR File is not specified, or the specified folder doesn�t exist.

DICOM_ERROR_FILE

201

The file doesn�t reside in the destination folder of the DICOMDIR File or in a subfolder of it, or the file doesn�t exist.

DICOM_ERROR_FILEID

202

The File ID of the specified file is invalid. Refer to the RejectInvalidFileID property for more information.

DICOM_ERROR_J2K_LOCKED

203

J2K support is locked.

DICOM_ERROR_LUT_DESCRIPTOR_MISSING

204

LUT descriptor is missing.

DICOM_ERROR_MODALITY_LUT_MISSING

205

Modality LUT is missing.

DICOM_ERROR_BAD_PIXEL_REPRESENTATION

206

Bad pixel representation.

DICOM_ERROR_PALETTECOLORLUTDATAMISSING

207

Palette color LUT is missing.

DICOM_ERROR_FEATURE_NOT_SUPPORTED

208

Feature not supported.

DICOM_ERROR_VOI_LUT_MISSING

209

VOI LUT is missing.

DICOM_ERROR_OVERLAY_ATTRIBUTES_MISSING

210

Overlay attributes are missing.

DICOM_ERROR_OVERLAY_ACTIVATIONLAYER_MISSING

211

Overlay activation layer element is missing.

DICOM_ERROR_OVERLAY_DATA_MISSING

212

Overlay data element is missing.

DICOM_ERROR_INVALID_STRUCT_SIZE

213

Invalid structure size.

DICOM_ERROR_NULL_PTR

214

NULL pointer.

DICOM_ERROR_LTIMG_MISSING

215

LTIMG DLL is missing.

DICOM_ERROR_CRYPTO_LIB_LOAD_FAILED

216

Failed to load the underlying cryptographic library.

DICOM_ERROR_INVALID_MAC_TRANSFER_SYNTAX

217

Unable to change to the MAC Calculation Transfer Syntax.

DICOM_ERROR_PRIVATE_KEY_LOAD_FAILED

218

Failed to load the private key from the specified file.

DICOM_ERROR_CERTIFICATE_LOAD_FAILED

219

Failed to load the digital certificate from the specified file.

DICOM_ERROR_CERTIFICATE_READ_FAILED

220

Failed to read the digital certificate from the Data Set.

DICOM_ERROR_KEYS_MISMATCH

221

The specified private key doesn�t match the public key in the specified digital certificate.

DICOM_ERROR_INVALID_MAC_ALGORITHM

222

The specified Digital Signature Security Profile doesn�t allow the use of the specified MAC Algorithm.

DICOM_ERROR_INVALID_ENCRYPTION_ALGORITHM

223

The specified Digital Signature Security Profile doesn�t allow the use of the encryption algorithm implied by the specified keys.

DICOM_ERROR_MAC_ID_NUMBER_ALLOCATE_FAILED

224

All possible values for the MAC ID Number are already used in the associated MAC Parameters Sequence.

DICOM_ERROR_CRYPTO_LIB_FAILURE

225

The underlying cryptographic library failed.

DICOM_ERROR_MAC_PARAMETER_MISSING

226

Failed to verify the Digital Signature because one or more of the MAC Parameters are missing.

DICOM_ERROR_MAC_ID_NUMBER_MISSING

227

Failed to verify the Digital Signature because no MAC Parameters Sequence Item is referenced.

DICOM_ERROR_UNKNOWN_MAC_ALGORITHM

228

Failed to verify the Digital Signature because the specified MAC Algorithm is unknown.

DICOM_ERROR_SIGNATURE_MISSING

229

Failed to verify the Digital Signature because the Signature is missing.

DICOM_ERROR_INVALID_SIGNATURE

230

The Digital Signature is invalid or at least one of the Digital Signatures in the Data Set is invalid.

DICOM_ERROR_CMP_FILTER_MISSING

231

LFCMP DLL is missing.

DICOM_ERROR_J2K_FILTER_MISSING

232

LFJ2K DLL is missing.

DICOM_ERROR_CANT_REPLACE_EXISTING_CHARACTER_SET

233

Cannot replace Existing Character Set.

DICOM_ERROR_DIR_STOP_INSERT_FILE

234

Unable to insert data set into DICOMDIR.

DICOM_ERROR_PRIVATE_CREATOR_GROUP_INVALID

235

Private creator group number is invalid.

DICOM_ERROR_PRIVATE_CREATOR_DATA_ELEMENT_ALREADY_EXISTS

236

Private creator data element already exists.

DICOM_ERROR_PRIVATE_CREATOR_DATA_ELEMENT_MISSING

237

Private creator data element is missing.

DICOM_ERROR_PRIVATE_CREATOR_ELEMENTS_ALL_ALLOCATED

238

All private creator elements have been allocated for this group.

DICOM_ERROR_ENCAPSULATED_DOCUMENT_MISSING

240

Encapsulated document is missing.

DICOM_ERROR_INVALID_ELEMENT_LENGTH

241

Element length is invalid.

DICOM_ERROR_ENCAPSULATED_DOCUMENT_FAILURE

242

Failed to extract the encapsulated document.

DICOM_ERROR_ENCAPSULATED_DOCUMENT_INVALID_TYPE

243

Type must be ENCAPSULATED_DOCUMENT_PDF or ENCAPSULATED_DOCUMENT_CDA.

DICOM_ERROR_PRINTSCU_CLASS_NOT_SUPPORTED

301

The required SOP/Meta SOP Class is not supported on the Association (refer to the method itself).

DICOM_ERROR_PRINTSCU_TIME_OUT

302

Timed out (refer to the Timeout property).

DICOM_ERROR_PRINTSCU_ASSOCIATE_RQ_REJECTED

303

The Association request was rejected by the Print SCP (refer to the Associate method).

DICOM_ERROR_PRINTSCU_FAILURE_STATUS

304

The response of the Print SCP specifies a Failure status code (the operation was not performed).