Obtaining externalized strings

A built-in function for use by internal applications only (SDK and other VMware adopting applications) may be used to retrieve an externalized string. The getExternalString() function extracts a string, based on the table name, key, and locale that is passed to the function. The getExternalString() function then renders the extracted string given a list of substitutions (up to six).

         <var> = getExternalString(<table>, <key>, <locale>)

The <table> and <key> arguments are required. The <locale> argument is optional. The default value is the value of the SM_LOCALE environment variable. The return value is the UTF-8 encoded string that contains the text of the message defined in the table.

The ASL script may then use the returned string as an argument in the print() built-in function, as shown in the following example:

msg = getExternalString("SMS_MSG","SUCCESS","fr_FR");
print(msg);