KLDAP::LdapConnection Class Reference

This class represents a connection to an LDAP server. More...

#include <ldapconnection.h>

List of all members.

Public Types
enum	SASL_Fields { SASL_Authname = 0x1, SASL_Authzid = 0x2, SASL_Realm = 0x4, SASL_Password = 0x8 }
Public Member Functions
void	close ()
int	connect ()
QString	connectionError () const
int	getOption (int option, void *value) const
void *	handle () const
	LdapConnection (const LdapServer &server)
	LdapConnection (const LdapUrl &url)
	LdapConnection ()
int	ldapErrorCode () const
QString	ldapErrorString () const
QString	saslErrorString () const
void *	saslHandle () const
const LdapServer &	server () const
int	setOption (int option, void *value)
void	setServer (const LdapServer &server)
bool	setSizeLimit (int sizelimit)
bool	setTimeLimit (int timelimit)
void	setUrl (const LdapUrl &url)
int	sizeLimit () const
int	timeLimit () const
Static Public Member Functions
static QString	errorString (int code)

---

Detailed Description

This class represents a connection to an LDAP server.

Definition at line 36 of file ldapconnection.h.

---

Constructor & Destructor Documentation

LdapConnection::LdapConnection

(

)

Constructs an LdapConnection object.

Definition at line 88 of file ldapconnection.cpp.

LdapConnection::LdapConnection

(

const LdapUrl &

url

)

[explicit]

Constructs an LdapConnection with the parameters given in url.

Definition at line 94 of file ldapconnection.cpp.

LdapConnection::LdapConnection

(

const LdapServer &

server

)

[explicit]

Constructs an LdapConnection with the parameters given in server.

Definition at line 101 of file ldapconnection.cpp.

---

Member Function Documentation

void LdapConnection::close

(

)

Closes the LDAP connection.

Definition at line 425 of file ldapconnection.cpp.

int LdapConnection::connect

(

)

Sets up the connection parameters with creating a handle to the LDAP server.

Also sets sizelimit and timelimit and starts TLS if it is requested. Returns 0 if successful, else returns an LDAP error code, and an error string which is available via connectionError().

Definition at line 415 of file ldapconnection.cpp.

QString LdapConnection::connectionError

(

)

const

Returns a translated error string if connect() failed.

Definition at line 168 of file ldapconnection.cpp.

QString LdapConnection::errorString

(

int

code

)

[static]

Returns a translated error message from the specified LDAP error code.

Definition at line 139 of file ldapconnection.cpp.

int LdapConnection::getOption	(	int	option,
		void *	value
	)			const

Gets an option from the connection.

The option value can be client library specific, so avoid this function if possible

Definition at line 367 of file ldapconnection.cpp.

void * LdapConnection::handle

(

)

const

Returns the opaqe client-library specific LDAP object.

Avoid its usage if you can.

Definition at line 129 of file ldapconnection.cpp.

int LdapConnection::ldapErrorCode

(

)

const

Returns the LDAP error code from the last operation.

Definition at line 379 of file ldapconnection.cpp.

QString LdapConnection::ldapErrorString

(

)

const

Returns the LDAP error string from the last operation.

Definition at line 385 of file ldapconnection.cpp.

QString LdapConnection::saslErrorString

(

)

const

Returns the SASL error string from the last SASL operation.

Definition at line 155 of file ldapconnection.cpp.

void * LdapConnection::saslHandle

(

)

const

Returns the opaqe sasl-library specific SASL object.

Avoid its usage if you can.

Definition at line 134 of file ldapconnection.cpp.

const LdapServer & LdapConnection::server

(

)

const

Returns the connection parameters which was specified with an LDAP Url or a LdapServer structure.

Definition at line 124 of file ldapconnection.cpp.

int LdapConnection::setOption	(	int	option,
		void *	value
	)

Sets an option in the connection.

The option value can be client library specific, so avoid this function if possible

Definition at line 373 of file ldapconnection.cpp.

void LdapConnection::setServer

(

const LdapServer &

server

)

Sets the connection parameters via the specified server structure.

After this, you need to call connect() to connect with the new parameters.

Definition at line 119 of file ldapconnection.cpp.

bool LdapConnection::setSizeLimit

(

int

sizelimit

)

Sets the size limit for the connection.

Definition at line 391 of file ldapconnection.cpp.

bool LdapConnection::setTimeLimit

(

int

timelimit

)

Sets the time limit for the connection.

Definition at line 403 of file ldapconnection.cpp.

void LdapConnection::setUrl

(

const LdapUrl &

url

)

Sets the connection parameters via the specified url.

After this, you need to call connect() to connect with the new parameters.

Definition at line 114 of file ldapconnection.cpp.

int LdapConnection::sizeLimit

(

)

const

Returns the current size limit.

Definition at line 397 of file ldapconnection.cpp.

int LdapConnection::timeLimit

(

)

const

Returns the current time limit.

Definition at line 409 of file ldapconnection.cpp.

---

The documentation for this class was generated from the following files:

• ldapconnection.h
• ldapconnection.cpp