Directory Services

LdapUTF8ToUnicode

Call the LdapUTF8ToUnicode function to translate strings for modules that do not have the UTF-8 code page.

int LdapUTF8ToUnicode(
  LPCSTR lpSrcStr,
  int cchSrc,
  LPWSTR lpDestStr,
  int cchDest
);

Parameters

lpSrcStr
[in] Pointer to a null-terminated UTF-8 string to convert.
cchSrc
[in] Specifies the number of characters in the lpSrcStr string.
lpDestStr
[out] Pointer to a buffer that receives the converted Unicode string, without a null terminator.
cchDest
[in] Specifies the size, in characters, of the lpDestStr buffer.

Return Values

The return value is the number of characters written to the lpDestStr buffer.

If the lpDestStr buffer is too small, GetLastError returns ERROR_INSUFFICIENT_BUFFER.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Winldap.h.
Library: Use Wldap32.lib.

See Also

Functions, LdapUnicodeToUTF8