ldap_ufn2dn 函数 (winldap.h)

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函数尝试将用户指定的名称规范化为可分辨名称。 例如,考虑公用名 LastNameFirstName 的 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

请参阅

函数

返回值

ldap_memfree