Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function is used to begin the traversal of a SET, SET OF, SEQUENCE, or SEQUENCE OF data values stored in the supplied BerElementstructure. 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_elementfunction.

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 pLenand ppOpaquevalues 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
Windows Mobile Windows Mobile Version 5.0 and later

See Also