Get a cross platform HTML string resource by ID
Get a cross platform HTML string resource by ID. This function makes localization easier for cross platform strings used for generating HTML. The cross platfrom string resources are defined in allxpstr.h. You should use XP_GetStringForHTML when:
The code checks the current CharSetID in the resource and the CharSetID of the data from the net. If they are equal, it returns the string defined in the resource, otherwise, it will return the English version. So a French client can display French if the data from the net is in the CharSetID of French and it will use half English and half Japanese if the French client receives Japanese data from the net. The caller should make a copy of the returned string if it needs to use it for a while. The same memory buffer will be used to store another string the next time this function get called. The caller does not need to free the memory of the returned string.
- Human readable string not defined in front-end
- The code generates HTML page and will go into HTML window
- Only use this when the message will be generated into HTML.
- Only use this if you can access to the winCharSetID.
- This is needed because half of the text is generated from resource (in resource charset) and half of the text is coming from the net (in winCharSetID charset). When we meet this kind of mixing charset condition. We use this function instead of XP_GetString().
- Localized (translated) string if the winCharSetID matches the CharSetID of the resource. Otherwise it returns the English message or the English string
- id - Specifies the string resource ID
winCharSetID - Specifies the winCharSetID of the HTML
english - Specifies the English string
- See Also:
generated by doc++