Table of Contents | Previous | Next | Index

Netscape Directory SDK 3.0 for C Programmer’s Guide
     Chapter 18 Functions

ldap_get_lang_values()

The ldap_get_lang_values() function returns a NULL-terminated array of an attribute's string values that match a specified language subtype.

If you want to retrieve binary data from an attribute, call the ldap_get_lang_values_len() function instead.

Syntax

#include <ldap.h>
char ** ldap_get_lang_values( LDAP *ld, LDAPMessage *entry,
   const char *target, char **type );

Parameters

This function has the following parameters:

ld

Connection handle, which is a pointer to an LDAP structure containing information about the connection to the LDAP server.

entry

Entry retrieved from the directory.

target

Attribute type (including an optional language subtype) that you want to retrieve the values of

type

Pointer to a buffer that returns the attribute type retrieved by this function.

Returns

One of the following values:

Description

Unlike the ldap_get_values() function, if a language subtype is specified, this function first attempts to find and return values that match that subtype (for example, cn;lang-en).

See Also

ldap_first_entry(), ldap_next_entry(), ldap_first_attribute(), ldap_next_attribute(), ldap_get_lang_values_len(), ldap_get_values().


Table of Contents | Previous | Next | Index

Last Updated: 10/01/98 17:06:23