Sun Directory Server Enterprise Edition 7.0 Developer's Guide

slapi_vattr_values_get_ex()

Returns the values for an attribute type from an entry.

Syntax

#include "slapi-plugin.h"
int slapi_vattr_values_get_ex(Slapi_Entry *e, char *type,
    Slapi_ValueSet*** results, int **type_name_disposition,
    char ***actual_type_name, int flags, int *buffer_flags,
    int *subtype_count);

Parameters

This function takes the following parameters:

e

Entry from which to get the values.

type

Attribute type name.

results

Pointer to result set.

type_name_disposition

Matching result.

actual_type_name

Type name as found.

flags

Bit mask of options. Valid values are as follows:

  • SLAPI_REALATTRS_ONLY

  • SLAPI_VIRTUALATTRS_ONLY

  • SLAPI_VIRTUALATTRS_REQUEST_POINTERS

  • SLAPI_VIRTUALATTRS_LIST_OPERATIONAL_ATTRS

buffer_flags

Bit mask to be used as input flags for slapi_vattr_values_free() .

subtype_count

Number of subtypes matched.

Returns

This function returns 0 for success, in which case:

Description

This function returns the values for an attribute type from an entry, including the values for any subtypes of the specified attribute type. The routine will return the values of virtual attributes in that entry if requested to do so.

Memory Concerns

slapi_vattr_values_free() should be used to free the returned result set and type names, passing the buffer_flags value returned from this routine.

See Also

slapi_vattr_values_free()