Directory Services

ber_skip_tag

The ber_skip_tag function skips over the current tag and returns the tag of the next element in the supplied BerElement structure.

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

Parameters

pBerElement
[in] Pointer to the source BerElement structure.
pLen
[out] Returns the length of the element just skipped over.

Return Values

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

Remarks

This routine is similar to ber_peek_tag, except that the state pointer in the BerElement argument is advanced past the first tag and length, and is pointed to the value part of the next element. This routine should only be used with constructed types and situations when a BER encoding is used as the value of an OCTET STRING.

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_peek_tag, ber_first_element, ber_next_element