Directory Services

ber_next_element

The ber_next_element function is used along with ber_first_element to traverse a SET, SET OF, SEQUENCE or SEQUENCE OF data value stored in the supplied BerElement structure. It returns the tag and length of the next element in the constructed type.

ULONG ber_next_element(
  BerElement* pBerElement,
  ULONG* pLen,
  CHAR* opaque
);

Parameters

pBerElement
[in] Pointer to the source BerElement structure.
pLen
[in, out] Returns the length of the next element to be parsed.
opaque
[in, out] An opaque cookie used internally that was returned by the initial call to the ber_first_element function.

Return Values

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

Remarks

The pLen and opaque pointer values returned by the function are internal parsing state values, and should not be used by applications other than as arguments to subsequent calls of this function.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Winber.h.
Library: Use Wldap32.lib.

See Also

ber_skip_tag, ber_peek_tag, ber_first_element