WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsILDAPAutoCompleteSession

IID:aced5f6f-013d-4e21-97a6-9da3779c8663
Inherits From:nsIAutoCompleteSession

Extends nsIAutoCompleteSession to have various LDAP-specific parameters. and output format.

This interface is implemented by the following components:

Properties

PRUint32 cjkMinStringLength

AUTF8String filterTemplate

A template used to construct the RFC 1960 LDAP search filter to use while autocompleting.

The authoritative documentation for the format in use can be found at at . The Linux/OpenLDAP man page for ldapfilter.conf(5) does a pretty decent job as well, however.

As of this writing, the "@mozilla.org/autocompleteSession;1?type=ldap" contractid happens to use a default value of ((cn=%v1*%v2-*)(mail=%v1*%v2-*)(sn=%v1*%v2-*))

nsILDAPAutoCompFormatter formatter

Callback used to format an individual LDAP message into an nsIAutoCompleteItem.

AUTF8String login

"Login as..." this ID. Currently, this must be specified as a DN. In the future, we may support userid and/or email address as well. If unset, bind anonymously.

PRInt32 maxHits

At most this many nsIAutoCompleteItems will be returned. This is useful for keeping bandwidth usage over slow-speed connections as well as ensuring that the number of choices offered in the UI is manageble.

1-65535 are interpreted literally 0 means "unlimited" -1 uses the default limit for the LDAP connection in use

PRUint32 minStringLength

Strings shorter than this will return nsIAutoCompleteStatus::ignored rather than triggering a search. This allows browsers to be configured to not search on substrings so short that they aren't indexed by the LDAP server (such searches can use significantly more server resources and return a very large number of entries). cjkMinStringLength is used for CJK languages, and minStringLength for everything else. As of this writing, the "@mozilla.org/autocompleteSession;1?type=ldap" contractid uses defaults of two and zero, respectively. This avoids most unindexed searches with at least one widely-deployed webserver, but allows CJK languages, where a single glyph can be an an entire name to still get results.

nsIMutableArray searchClientControls

nsIMutableArray searchServerControls

If set, these arrays of nsILDAPControls are passed through to the nsILDAPOperation that searchExt is called on.

nsILDAPURL serverURL

LDAP server to complete against, in ldap: URL format. May change to an nsILDAPServer once that infrastructure lands.

PRUint32 version

What version of the LDAP protocol should be used? Allowed version number constants are defined in nsILDAPConnection.idl.

Reference documentation is generated from Mozilla's source.