EPLAN.EPLAN21.DESTINATION_LANGUAGE.REMOVE

Contents

Description

Command for removing languages from the list of the languages to be translated.

Parameters

ParameterID Type Description
EPL_PARAM_DESTINATION_LANGUAGES [IN]
String
This parameter contains the languages, that are to be removed from the list of languages to be translated, in the form of a string. The languages are specified by the country code. If the parameter contains more than one language, the codes will be entered directly one after the other without a separator.

Error Messages

The eplExecuteCommand function returns EPL_OK if the command could be successfully executed.

If the command fails, eplExecuteCommand returns the value EPL_ERROR. In this case, the error log can contain the following errors:

ErrorID Description
EPL_ERR_GENERAL An unexpected exception error has occurred.
EPL_ERR_INVALID_ARGUMENT The languages contained in the DESTINATION_LANGUAGES parameter contain the current default language. The default language cannot be removed from the list of languages to be translated.

Example

The following simple example shows a function that removes the English and German languages from the list of languages to be translated.

void removeDestinationLanguages()
{
       EplSession hSession = eplCreateSession();
       EplHandle hCmd = eplCreateCommand(hSession,
                                        L"EPLAN.EPLAN21.DESTINATION_LANGUAGE.REMOVE");

       // No display in German or English:
       eplSetParam(hSession,
                   hCmd,
                   EPL_PARAM_DESTINATION_LANGUAGES,
                   L"DEEN",
                   0);
       eplExecuteCommand(hSession, hCmd);
       eplCloseObject(hSession, hCmd);
       eplDestroySession(hSession);
}

Reference