ldapGetValues(3ibx) — Subroutines

NAME

ldapGetValues − Returns an array of pointers (a vector) that point to attribute-value strings.

SYNOPSIS


#include <libldap.h>

char ∗∗ ldapGetValues(	LDAP_t ∗ldap_handle,
	LDAPM_t ∗directory_entry,
	char ∗attribute_name );

INPUT PARAMETERS

ldap_handleThe address of an LDAP handle.

directory_entryThe address a directory entry, which was returned by a call to either the ldapFirstEntry or ldapNextEntry function.

attribute_nameA pointer to an attribute name, which was returned by a call to either the ldapFirstAttribute or ldapNextAttribute function.

DESCRIPTION

The ldapGetValues function returns an array of pointers to attribute-value strings. Search through these strings until you encounter a NULL address in the array of pointers. When you are finished reading the values, free the memory used by the array of pointers by calling the ldapValueFree function.

RETURNS

An array of pointers whose pointers point to character strings of attribute values, the last of which is the NULL address; or NULL, if the directory entry has no attribute values.

RELATED INFORMATION

Functions: ldapFirstAttribute(3), ldapNextAttribute(3), ldapFirstEntry(3), ldapNextEntry(3).

Museum