Localization

This category exposes the translations stored in agent binaries if the integrator wants to replace some UI of the agent and take advantage of the existing translations. This is read-only access to the dictionary by id or message id.

Functions

HSDCError HSDCAPI HSDCGetStringById (unsigned long id, wchar_t **pStr)

Gets a string from the dictionary identified by its id. The language is matched using the user LCID, then the system LCID, then it falls back to English.

HSDCError HSDCAPI HSDCGetStrings (char **pJstr)

Gets all strings from the dictionary. The language is matched using the user LCID, then the system LCID, then it falls back to English.

Function Documentation

HSDCGetStringById()

HSDCError HSDCAPI HSDCGetStringById ( unsigned long id, wchar_t ** pStr )

Gets a string from the dictionary identified by its id. The language is matched using the user LCID, then the system LCID, then it falls back to English.

Parameters

id	Identifier of the string (a full list can be extracted by calling HSDCGetStrings).
pStr	Unicode string associated with the id in the current localization (for supported languages, see the release notes).

Returns

HSDCErrorSuccess	The operation succeeded
HSDCErrorInvalidArg	Input was nullptr
HSDCErrorUnexpected	Unexpected error

HSDCGetStrings()

HSDCError HSDCAPI HSDCGetStrings ( char ** pJstr )

Gets all strings from the dictionary. The language is matched using the user LCID, then the system LCID, then it falls back to English.

Parameters

pJstr

A non-null pointer to a char pointer. This is set to point to a Unicode JSON string containing a set of translated string per supported language. Formatted as below.

Copy

{
  "lcid" : "1033",
  "strings" : [
     { "id" : "104", "text" : "http://www.ivanti.com"  },
     ...
  ]
}

Returns

HSDCErrorSuccess	The operation succeeded
HSDCErrorInvalidArg	Input was nullptr
HSDCErrorUnexpected	Unexpected error