Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

ldap_get_dn function

The ldap_get_dn function retrieves the distinguished name for a given entry.

Syntax


PCHAR ldap_get_dn(
  _In_  LDAP *ld,
  _In_  LDAPMessage *entry
);

Parameters

ld [in]

The session handle.

entry [in]

The entry whose distinguished name is to be retrieved.

Return value

If the function succeeds, it returns the distinguished name as a pointer to a null-terminated character string.

If the function fails, it returns NULL and sets the session error parameters in the LDAP data structure.

Remarks

The ldap_get_dn function retrieves the distinguished name for an entry that was returned by ldap_first_entry, or ldap_next_entry. When the returned name is no longer needed, free the string by calling ldap_memfree.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winldap.h

Library

Wldap32.lib

DLL

Wldap32.dll

Unicode and ANSI names

ldap_get_dnW (Unicode) and ldap_get_dnA (ANSI)

See also

Functions
LDAP
ldap_first_entry
ldap_memfree
ldap_next_entry

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.