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.

nsILDAPConnection

IID:360c1ff7-15e3-4ffe-b4b8-0eda72ebc096
Inherits From:nsISupports

This interface is implemented by the following components:


Constants

PRUint32 VERSION2 = 2
PRUint32 VERSION3 = 3

Properties

readonly AUTF8String bindName

DN to bind as. use the init() method to set this.

nsISupports closure

Private parameter (anything caller desires)

readonly PRUnichar* errorString

The string version of lderrno


Methods

PRInt32 getLdErrno ( out AUTF8String matched , out AUTF8String s ) void init ( nsILDAPURL url , AUTF8String bindName , nsILDAPMessageListener messageListener , nsISupports closure , PRUint32 version )

PRInt32 getLdErrno ( out AUTF8String matched , out AUTF8String s )

Get information about the last error that occured on this connection.

Arguments:
matched: if the server is returning LDAP_NO_SUCH_OBJECT, LDAP_ALIAS_PROBLEM, LDAP_INVALID_DN_SYNTAX, or LDAP_ALIAS_DEREF_PROBLEM, this will contain the portion of DN that matches the entry that is closest to the requested entry
s: additional error information from the server
Returns:
nsILDAPErrors.idl

void init ( nsILDAPURL url , AUTF8String bindName , nsILDAPMessageListener messageListener , nsISupports closure , PRUint32 version )

Set up the connection. Note that init() must be called on a thread that already has an nsIEventQueue.

Arguments:
url: A URL for the ldap server. The host, port and ssl connection type will be extracted from this
bindName: DN to bind as
messageListener: Callback for DNS resolution completion
closure: private parameter (anything caller desires)
version: LDAP version to use (currently VERSION2 or VERSION3)

References

This interface is the type of the following properties:

nsILDAPOperation.connection

This interface is passed as an argument to the following methods:

nsIAbLDAPProcessReplicationData.init, nsILDAPMessageListener.onLDAPInit, nsILDAPOperation.init

This interface is returned from the following methods:

nsILDAPService.getConnection

Reference documentation is generated from Mozilla's source.

Copyright © 1999-2006 XULPlanet.com