Export (0) Print
Expand All
Expand Minimize

ber_first_element function

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


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

Parameters

pBerElement [in]

Pointer to the source BerElement structure.

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Winber.h

Library

Wldap32.lib

DLL

Wldap32.dll

See also

ber_skip_tag
ber_peek_tag
ber_next_element

 

 

Show:
© 2014 Microsoft