| Error codes -400 through -599 are errors returned by DS server-based client API library functions. They are typically generated by the DS module and other related modules, such as DSRepair. However, certain DS processes require the functionality from server modules such as the Unicode module. If one of these supporting modules encounters an error, the error may be passed back to DS, and the DS module will then report the error. You generally do not encounter these error codes because they are mostly trapped and handled by the modules. But in case you do encounter these error codes, they are included here for your reference. NOTE In general, the error codes listed in this section are of more interest to programmers writing DS -aware applications than they are to network administrators.
Table 5.3 shows common DS client API library error codes specific to server-based applications. You can find a complete list of all the DS client API library error codes specific to server-based applications in Appendix A. Table 5.3. Common DS Client API Library Error Codes Specific to Server-Based Modules | DECIMAL | HEXADECIMAL | CONSTANT | | -400 | 0xFFFFFE70 | ERR_BAD_SERVICE_CONNECTION | | -401 | 0xFFFFFE6F | ERR_BAD_NETWORK | | -403 | 0xFFFFFE6D | ERR_SLOT_ALLOCATION | | -405 | 0xFFFFFE6B | ERR_BAD_SERVER_NAME | | -406 | 0xFFFFFE6A | ERR_BAD_USER_NAME | | -408 | 0xFFFFFE68 | ERR_NO_MEMORY | | -412 | 0xFFFFFE64 | ERR_CONNECTION_ABORTED | | -413 | 0xFFFFFE63 | ERR_TIMEOUT | | -414 | 0xFFFFFE62 | ERR_CHECKSUM |
Many server-based API functions require the application to first be attached to and authenticated to the target server (thus receiving a valid server handle). If the application failed to first obtain a valid server handle before making the API call, error -400 is returned. NOTE The -400 error could also indicate that the target server is not available. Therefore, before you jump to the conclusion that there is a bug in the application, check that the target server is reachable .
The other most commonly encountered errors in this category are -405 and -406. These error codes result when one or more illegal characters are found in the server name and usernames, respectively. For example, depending on the API in question, the specified server name may just be the CN portion of the object name (such as TEST_SERVER1 ) rather than the full object name (such as TEST_SERVER1.Org_Unit.Org ); the dots in the name would be considered illegal characters. NOTE As discussed in Chapter 2, " eDirectory Basics ," although a DS object name may be up to 255 characters in length, including context information, the CN portion of the object name is limited to 64 characters.
| 