|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
This function converts a user-friendly name to a distinguished name.
ULONG ldap_ufn2dn( UNICODE PTCHAR ufn, UNICODE PTCHAR* pDn );
[in] Pointer to a null-terminated string containing the user-friendly name to be converted.
[out] Pointer to a variable that receives a pointer to a null-terminated string containing the resulting distinguished name.
If the pDnparameter comes back as non-NULL, you should free it when you are done with a call to the ldap_memfreefunction.
If this function succeeds, the return value is LDAP_SUCCESS.
If this function fails, it returns an error code. See the LDAP_RETCODEenumeration for a list of possible return values.
This 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 "Jane Doe," this function will attempt to normalize this to "Doe, Jane." The function follows RFC 1781 (add CN= if not present, add OU= if none present, and so on). If it runs into any problems at all while normalizing, the function returns a copy of what was passed. It then allocates the output string from the LDAP memory pool.
|Windows Embedded CE||Windows CE .NET 4.0 and later|
|Windows Mobile||Windows Mobile Version 5.0 and later|