ber_peek_tag

The ber_peek_tag function returns the tag of the next element to be parsed in the supplied BerElement structure.

ULONG ber_peek_tag(
  BerElement* pBerElement,
  ULONG* pLen
);

Parameters

pBerElement

[in] Pointer to the source BerElement structure.

pLen

[out] Returns the length of the next element to be parsed.

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 decoding position within the pBerElement parameter is unchanged by this call; that is, the fact that ber_peek_tag has been called does not affect future use of the BerElement structure.

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_first_element, ber_next_element