ErrorNumber (LDAP function)

From m204wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Error number of the most recent LDAP error (LDAP class)


This method is a readOnly property that reports the error number from the last LDAP method for which an error number was returned.

Syntax

%number = ldap:ErrorNumber

Syntax terms

%number A float variable to contain the integer-valued error number.
LDAP An LDAP object variable.

Usage notes

  • The ErrorText property reports a short description of the error associated with the ErrorNumber value or additional information related to the error.
  • The ErrorNumber value will be the same as the status return from LDAP methods for problems "internal" to the client, will contain a value from a related error, or will contain a value from a server-reported error.
  • If an ErrorNumber (and text) contain information reported by the server, they may conform to the LDAP RFC, which lists dozens of such server result codes (positive integers) and descriptions, but no accompanying diagnostic text for these codes is standardized.

Examples

  • An LDAP Bind call fails and returns a status value of -110, which indicates a problem with the Janus port definition. When the following statement was issued:

    Print 'Error number is ': ' %ld:ErrorNumber

    The result was: Error number is -110. ErrorNumber and status return both point to the client fault.

  • An LDAP Find call fails and returns a status value of -5, which indicates an "error obtained from server." When the following statement was issued:

    Print 'Error number is ': ' %ld:ErrorNumber

    The result was: Error number is 4, and the ErrorText string indicated that "the size limit of returned entries has been exceeded." ErrorNumber and status return, though different, both point to a server issue.

See also