ldap_ufn2dn函数将用户友好名称转换为可分辨名称。
语法
WINLDAPAPI ULONG LDAPAPI ldap_ufn2dn(
[in] const PSTR ufn,
[out] PSTR *pDn
);
参数
[in] ufn
指向以 null 结尾的字符串的指针,该字符串包含要转换的用户友好名称。
[out] pDn
指向变量的指针,该变量接收指向包含生成的可分辨名称的以 null 结尾的字符串的指针。
如果 pDn 参数返回非 NULL,请通过调用 ldap_memfree 释放它。
返回值
如果函数成功,则 返回值LDAP_SUCCESS。
如果该函数失败,它将返回错误代码。 有关详细信息,请参阅 返回值。
注解
ldap_ufn2dn函数尝试将用户指定的名称规范化为可分辨名称。 例如,考虑公用名 LastName、 FirstName 的 LDAP 目录格式。 如果目录名称为“Jeff Smith”, ldap_ufn2dn 将尝试将其规范化为“Smith,Jeff”。函数遵循 RFC 1781;如果不存在,则添加 CN= ,如果不存在,则添加 OU= ,依此而行。 如果在规范化时遇到任何错误,该函数将返回所传递内容的副本。 然后,它从 LDAP 内存池分配输出字符串。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | winldap.h |
Library | Wldap32.lib |
DLL | Wldap32.dll |
请参阅
返回值