cwbNL_GetLang

Purpose

Get the current language setting.

Syntax

 
unsigned int CWB_ENTRY cwbNL_GetLang(
                             char           *mriBasePath,
                             char           *resultPtr,
                             unsigned short  resultLen,
                             unsigned short *requiredLen,
                             cwbSV_ErrHandle errorHandle);

Parameters

char * mriBasePath - input

Pointer to the mriBasePath, e.g. C:\Program Files\IBM\ClientAccess/400. If NULL, the mriBasePath of the ClientAccess/400 product is used.

char * resultPtr - output

Pointer to the buffer to contain the result.

unsigned short resultLen - input

Length of the result buffer. Recommended size is CWBNL_MAX_LANG_SIZE.

unsigned short * requiredLen - output

Actual length of the result. If requiredLen > resultLen, the return value will be CWB_BUFFER_OVERFLOW.

cwbSV_ErrHandle errorHandle - input

Any returned messages will be written to this object. It is created with the cwbSV_CreateErrHandle() API. The messages may be retrieved through the cwbSV_GetErrText() API. If the parameter is set to zero, no messages will be retrievable.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_HANDLE

Invalid handle.

CWB_INVALID_POINTER

NULL passed on output parameter.

CWB_NOT_ENOUGH_MEMORY

Insufficient memory.

CWB_BUFFER_OVERFLOW

Buffer too small to contain result.

Usage

The result buffer will contain the name of the language subdirectory. This language subdirectory contains the language-specific files. This language subdirectory name also can be passed to cwbNL_GetLangName.