LDAPValue (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

LDAP server and local LDAP object
Updating the local LDAP object
Accented characters

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LDAP functions

LDAPValue (Function)

In French: LDAPValeur

Returns the value corresponding to the subscript passed in parameter for the specified attribute.

Example

// Find out the value of "UserPassword" attribute, subscript 2
AttValue = LDAPValue("MySession", "CN=JP", "UserPassword", 2)

Syntax

<Result> = LDAPValue(<Session Name> , <Object DN> , <Attribute Name> [, <Subscript>])

<Result>: Character string

Value of attribute for the specified subscript.
Empty string if the value is empty or if an error occurred.

<Session Name>: Character string (with quotes)

Name of LDAP session used.

<Object DN>: Character string (with quotes)

Distinguished Name (DN) of the object whose attribute value is sought.

<Attribute Name>: Character string (with quotes)

Name of attribute whose value is sought. The object attributes are returned by LDAPListAttribute.

<Subscript>: Optional integer

Subscript of attribute value. If this parameter is not specified, the value of subscript 1 for the specified attribute is returned.

Remarks

LDAP server and local LDAP object

The LDAP server contains LDAP objects.

The local LDAP object is an LDAP object fetched from the server.

Updating the local LDAP object

When a read LDAP function is run (LDAPListAttribute, LDAPNbValue or LDAPValue), the server object is entirely fetched locally in order to limit the communications with the server. Therefore, if these read functions are called several times with the same DN, the communication with the server is established by the first call. The other calls will read the local object.

LDAPValue does not update the local LDAP object if the DN passed in parameter is identical to the last DN passed in parameter to one of the following functions: LDAPListAttribute, LDAPNbValue, LDAPValue. However, if LDAPValidateAdd and LDAPValidateModify have been used with this same DN, the local object is automatically updated.

Accented characters

If the server uses characters in UTF8, the value of the attribute may have to be converted in order to get the requested result. For example:

AttValue = UTF8ToString(LDAPValue("MySession", "CN=JP", "UserPassword", 2), charsetAnsi)

Related Examples:

Unit examples (WINDEV): The LDAP functions

[ + ] Using the WLanguage LDAP functions.
These functions are used to interact with the LDAP data, to view the content of any LDAP directory and to modify the LDAP data: LDAPConnect, LDAPListChildren, LDAPAdAttribute, LDAPDeleteAttributeValue, ...

Components

wd230com.dll