Share via


ber_first_element (Windows Embedded CE 6.0)

1/6/2010

This function is used to begin the traversal of a SET, SET OF, SEQUENCE, or SEQUENCE OF data values stored in the supplied BerElement structure. It returns the tag and length of the first element.

Syntax

ULONG ber_first_element(
  BerElement* pBerElement,
  ULONG* pLen,
  CHAR** ppOpaque
);

Parameters

  • pBerElement
    [in] Pointer to the source BerElement.
  • pLen
    [out] Returns the length of the next element to be parsed.
  • ppOpaque
    [out] Returns a pointer to a cookie that is passed to subsequent calls of the ber_next_element function.

Return Value

Returns the tag of the next element to be read in the BerElement. LBER_DEFAULT is returned if there is no further data to be read.

Remarks

The pLen and ppOpaque values returned by the function are internal parsing state values and should not be used by applications other than as arguments to ber_next_element.

Requirements

Header winber.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

ber_next_element
BerElement

Concepts

Other LDAP Functions