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 Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
ldap_get_dnW (Unicode) and ldap_get_dnA (ANSI) |
See also
Show: