LDAPMsg Class Reference

This class represents any type of LDAP- Message returned from the server. More...

#include <LDAPMessage.h>

Inheritance diagram for LDAPMsg:

List of all members.

Public Member Functions
virtual	~LDAPMsg ()
	The destructor has no implemenation, because this is an abstract class.
int	getMessageType ()
	Returns: The Type of message that this object contains.
int	getMsgID ()
	Returns: The message-ID that the C-API return for the Result-message.
bool	hasControls () const
	Returns: If any Control was sent back by the server this method returns true.
const LDAPControlSet &	getSrvControls () const
	Returns: Server controls that were sent back by the server.
Static Public Member Functions
static LDAPMsg *	create (const LDAPRequest *req, LDAPMessage *msg)
	This method is used by the library to parse the results returned by the C-API.
Static Public Attributes
static const int	BIND_RESPONSE = LDAP_RES_BIND
static const int	SEARCH_ENTRY = LDAP_RES_SEARCH_ENTRY
static const int	SEARCH_DONE = LDAP_RES_SEARCH_RESULT
static const int	SEARCH_REFERENCE = LDAP_RES_SEARCH_REFERENCE
static const int	MODIFY_RESPONSE = LDAP_RES_MODIFY
static const int	ADD_RESPONSE = LDAP_RES_ADD
static const int	DEL_RESPONSE = LDAP_RES_DELETE
static const int	MODDN_RESPONSE = LDAP_RES_MODDN
static const int	COMPARE_RESPONSE = LDAP_RES_COMPARE
static const int	EXTENDED_RESPONSE = LDAP_RES_EXTENDED
Protected Member Functions
	LDAPMsg (LDAPMessage *msg)
	This constructor make a copy of a LDAPMsg-pointer.
Protected Attributes
LDAPControlSet	m_srvControls
	This attribute stores Server-Control that were returned with the message.
bool	m_hasControls
Private Attributes
int	msgType
int	msgID

---

Detailed Description

This class represents any type of LDAP- Message returned from the server.

This class is never not instantiated directly. Only its subclasses are used. The main feature of this class is the static method create() (see below)

---

Constructor & Destructor Documentation

virtual LDAPMsg::~LDAPMsg

(

)

[inline, virtual]

The destructor has no implemenation, because this is an abstract class.

LDAPMsg::LDAPMsg

(

LDAPMessage *

msg

)

[protected]

This constructor make a copy of a LDAPMsg-pointer.

The object itself (no the pointer) is copied. Only for internal use.

---

Member Function Documentation

LDAPMsg * LDAPMsg::create	(	const LDAPRequest *	req,
		LDAPMessage *	msg
	)			[static]

This method is used by the library to parse the results returned by the C-API.

Based on msgtype-Value of the *msg-Parameter this method creates an Object of one of the subtypes of LDAPMsg (e.g. LDAPSearchResult or LDAPResult) that represents the same Message as the *msg-Parameter. *msg is e.g. a Message returned by the C-API's ldap_result call.

Parameters:

	req	The LDAPRequest-object this result message is associated with.
	msg	The LDAPMessage-structure from the C-API that contains the LDAP-message to parse.

Returns:

An Object of one of the subtypes of this class. It contains the parsed LDAP-message.

int LDAPMsg::getMessageType

(

)

Returns:

The Type of message that this object contains.

Possible values are:
BIND_RESPONSE
SEARCH_ENTRY
SEARCH_DONE
SEARCH_REFERENCE
MODIFY_RESPONSE
ADD_RESPONSE
DEL_RESPONSE
MODDN_RESPONSE
COMPARE_RESPONSE
EXTENDED_REPONSE

int LDAPMsg::getMsgID

(

)

Returns:

The message-ID that the C-API return for the Result-message.

bool LDAPMsg::hasControls

(

)

const

Returns:

If any Control was sent back by the server this method returns true.

Otherwise false is returned.

const LDAPControlSet & LDAPMsg::getSrvControls

(

)

const

Returns:

Server controls that were sent back by the server.

Note:

This feature is not test well yet.

---

Member Data Documentation

const int LDAPMsg::BIND_RESPONSE = LDAP_RES_BIND [static]

const int LDAPMsg::SEARCH_ENTRY = LDAP_RES_SEARCH_ENTRY [static]

const int LDAPMsg::SEARCH_DONE = LDAP_RES_SEARCH_RESULT [static]

const int LDAPMsg::SEARCH_REFERENCE = LDAP_RES_SEARCH_REFERENCE [static]

const int LDAPMsg::MODIFY_RESPONSE = LDAP_RES_MODIFY [static]

const int LDAPMsg::ADD_RESPONSE = LDAP_RES_ADD [static]

const int LDAPMsg::DEL_RESPONSE = LDAP_RES_DELETE [static]

const int LDAPMsg::MODDN_RESPONSE = LDAP_RES_MODDN [static]

const int LDAPMsg::COMPARE_RESPONSE = LDAP_RES_COMPARE [static]

const int LDAPMsg::EXTENDED_RESPONSE = LDAP_RES_EXTENDED [static]

LDAPControlSet LDAPMsg::m_srvControls [protected]

This attribute stores Server-Control that were returned with the message.

bool LDAPMsg::m_hasControls [protected]

int LDAPMsg::msgType [private]

int LDAPMsg::msgID [private]

---

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

• LDAPMessage.h
• LDAPMessage.cpp

---