Export (0) Print
Expand All
Expand Minimize

ldap_ufn2dn function

The ldap_ufn2dn function converts a user-friendly name to a distinguished name.

Syntax


ULONG ldap_ufn2dn(
  _In_   PCHAR ufn,
  _Out_  PCHAR *pDn
);

Parameters

ufn [in]

Pointer to a null-terminated string that contains the user-friendly name to convert.

pDn [out]

Pointer to a variable that receives a pointer to a null-terminated string that contains the resulting distinguished name.

If the pDn parameter returns non-NULL, free it with a call to ldap_memfree.

Return value

If the function succeeds, the return value is LDAP_SUCCESS.

If the function fails, it returns an error code. For more information, see Return Values.

Remarks

The ldap_ufn2dn function attempts to normalize a user-specified name to a distinguished name. For example, consider an LDAP directory format for a common name of LastName, FirstName. Given a directory name of "Jeff Smith," ldap_ufn2dn will attempt to normalize this to "Smith, Jeff." The function follows RFC 1781; add CN= if not present, add OU= if none present, and so on. If it runs into any errors while normalizing, the function returns a copy of what was passed. It then allocates the output string from the LDAP memory pool.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Winldap.h

Library

Wldap32.lib

DLL

Wldap32.dll

Unicode and ANSI names

ldap_ufn2dnW (Unicode) and ldap_ufn2dnA (ANSI)

See also

Functions
ldap_memfree
Return Values

 

 

Show:
© 2014 Microsoft