ldap_ufn2dn 函数将用户友好名称转换为可分辨名称。
语法
WINLDAPAPI ULONG LDAPAPI ldap_ufn2dnW(
[in] const PWSTR ufn,
[out] PWSTR *pDn
);
参数
[in] ufn
指向包含要转换的用户友好名称的 null 终止字符串的指针。
[out] pDn
指向一个变量的指针，该变量接收指向包含生成的可分辨名称的以 null 结尾的字符串的指针。
如果 pDn 参数返回非NULL，请释放它，并调用 ldap_memfree。
返回值
如果函数成功，则返回值 LDAP_SUCCESS。
如果函数失败，它将返回错误代码。 有关详细信息，请参阅 返回值。
言论
ldap_ufn2dn 函数尝试将用户指定的名称规范化为可分辨名称。 例如，请考虑 LastName的公用名的 LDAP 目录格式，FirstName。 鉴于目录名称为“Jeff Smith”，ldap_ufn2dn 将尝试将其规范化为“Smith，Jeff”。函数遵循 RFC 1781;add CN= if not present， add OU= if none present， and so on. 如果在规范化时遇到任何错误，该函数将返回传递的内容的副本。 然后，它会从 LDAP 内存池分配输出字符串。
注意
winldap.h 标头将ldap_ufn2dn定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | winldap.h |
| 库 | Wldap32.lib |
| DLL | Wldap32.dll |