ldap_set_iconv_local_charset()-- Set the Active LDAP Character Set

Syntax

 #include <ldap.h>
 
 int
 ldap_set_iconv_local_charset ( char *charset )

  Default Public Authority: *USE

  Library Name/Service Program: QSYS/QGLDCLNT

  Threadsafe: Yes

The ldap_set_iconv_local_charset() API checks if the character set is supported. If supported, the API calls ldap_set_iconv_local_codepage() to set the global variable ldap_global_codepage to a corresponding codepage value.

A limited set of the IANA character sets will be supported. Character sets supported include:

Character Set Name	Locale	Codepage
ISO-8859-1	EN_US	819
ISO-8859-2	HU_HU	912
ISO-8859-5	RU_RU	915
ISO-8859-6	AR_AA	1089
ISO-8859-7	EL_GR	813
ISO-8859-8	IW_IL	916
ISO-8859-9	TR_TR	920
IBM437	n/a	437
IBM850	EN_US	850
IBM852	n/a	852
IBM857	n/a	857
IBM862	n/a	862
IBM864	n/a	864
IBM866	n/a	866
IBM869	n/a	869
TIS-620	TH_TH	874
EUC-JP	JA_JP	954
EUC-KR	KO_KR	970
EUC-CN	ZN_CN	1383
EUC-TW	ZH_TW	964
Shift-JIS	JA_JP	932
GBK	ZH_CN	1386
Big5	ZH_TW	950

Authorities and Locks

No IBM^® i authority is required.

Parameters

charset: (input) specifies character set value.

Return Value

LDAP_SUCCESS: if the request was successful.
Other LDAP error code: if the request was not successful.

Error Conditions

The ldap_set_iconv_local_charset() API returns an LDAP error code if not successful. See LDAP Client API Error Conditions for possible values for LDAP error codes.

Error Messages

The following message may be sent from this function.

Message ID	Error Message Text
CPF3CF2 E	Error(s) occurred during running of ldap_set_iconv_local_charset API.

Related Information

ldap_xlate_local_to_utf8() -- Convert String From the Local to UTF-8 Code Page.
ldap_xlate_utf8_to_local() -- Convert String From UTF-8 to Local Code Page.
ldap_xlate_local_to_unicode() -- Convert String From the Local to UCS-2 Code Page.
ldap_xlate_unicode_to_local() -- Convert String From UCS-2 to Local Code Page.
ldap_get_iconv_local_codepage() -- Get the Active LDAP Code Page.
ldap_set_iconv_local_codepage() -- Set the Active LDAP Code Page.
ldap_set_locale() -- Change the Locale Used by LDAP.
ldap_get_locale() -- Get the Locale Used by LDAP.

API introduced: V4R5

[ Back to top | LDAP APIs | APIs by category ]