ber_first_element function (winber.h)

Article
02/22/2024

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

Syntax

WINBERAPI ULONG BERAPI ber_first_element(
  [in]  BerElement *pBerElement,
  [out] ULONG      *pLen,
  [out] CHAR       **ppOpaque
);

Parameters

[in] pBerElement

Pointer to the source BerElement structure.

[out] pLen

Returns the length of the next element to be parsed.

[out] ppOpaque

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 structure. 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

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	winber.h
Library	Wldap32.lib
DLL	Wldap32.dll