Re: Using GetPrivateProfileString to read unicode strings

Tech-Archive recommends: Repair Windows Errors & Optimize Windows Performance

Fair enough. If the API were created anytime within the last decade or so, I'm sure it would have been done more smartly. For portable settings files, XML format is a much more useful choice.

Joseph M. Newcomer wrote:
What is not obvious from this is that you must create the file yourself, external to the
WritePrivateProfileString. For example, I had assumed if I called
WritePrivateProfileStringW, I would get a Unicode version of the file, but the article
makes it clear that this really only deals with the input arguments, not the file format.
The fact that the file *cannot* be created as Unicode solely by the APIs is not at all
obvious from those statements.
joe

On Sat, 22 Aug 2009 22:41:11 -0500, Scot T Brennecke <ScotB@xxxxxxxxxxxxxxxxxx> wrote:

Both of these articles state "If the file exists and was created using Unicode characters, the function writes Unicode characters to the file. Otherwise, the function creates a file using ANSI characters."

WritePrivateProfileString Function (Windows):
http://msdn.microsoft.com/en-us/library/ms725501.aspx

WritePrivateProfileSection Function (Windows):
http://msdn.microsoft.com/en-us/library/ms725500.aspx


Joseph M. Newcomer wrote:
The error appears to be that it is not documented that it does this. I have no problem
with the design, but it needs to say that. According to the cited article, this fact is
not documented.

Note that I primarily am reporting errors of documentation. Sometimes I point out that
the design is flawed. But mostly, it is the omission of crtical information that should
have been written down.

The issue of "carrying settings around" sometimes suggests .INI files, so more people use
them than Microsoft intended. So the reality is that this behavior needs to be
documented, and the failure to provide clear documentation of this interesting behavior is
the "error" I want to cite.
joe

On Sat, 22 Aug 2009 15:50:37 -0500, Scot T Brennecke <ScotB@xxxxxxxxxxxxxxxxxx> wrote:

Come on, Joe. It's not an error. It's by design, and documented. Furthermore, it states this: "Note This function is provided only for compatibility with 16-bit versions of Windows. Applications should store initialization information in the registry." back in 16-bit days, we didn't even have Unicode.

Joseph M. Newcomer wrote:
Fascinating! Could I incorporate parts of that article into my MSDN Errors document, with
a hyperlink to your document?
joe

On Sat, 22 Aug 2009 01:04:10 -0700, "Mihai N." <nmihai_year_2000@xxxxxxxxx> wrote:

Can i use GetPrivateProfileString/WritePrivateProfileString to read/
write unicode strings from a file ?
Trick: if the file does not exist, or exists but it is not Unicode, then
the functions will convert everything to ANSI.
If you want to be unicode, then create an empty file with a BOM only
(FE FF) and then everything you write will be Unicode.

http://blogs.msdn.com/michkap/archive/2006/09/15/754992.aspx
Joseph M. Newcomer [MVP]
email: newcomer@xxxxxxxxxxxx
Web: http://www.flounder.com
MVP Tips: http://www.flounder.com/mvp_tips.htm
Joseph M. Newcomer [MVP]
email: newcomer@xxxxxxxxxxxx
Web: http://www.flounder.com
MVP Tips: http://www.flounder.com/mvp_tips.htm
Joseph M. Newcomer [MVP]
email: newcomer@xxxxxxxxxxxx
Web: http://www.flounder.com
MVP Tips: http://www.flounder.com/mvp_tips.htm
.

Relevant Pages

  • Re: Using GetPrivateProfileString to read unicode strings
    ... WritePrivateProfileStringW, I would get a Unicode version of the file, but the article ... WritePrivateProfileString Function: ... Note that I primarily am reporting errors of documentation. ...
    (microsoft.public.vc.mfc)
  • Re: Creating UNICODE filenames with PERL 5.8
    ... I didn't clue in from the documentation ... It comes back with a two character ... Do you know of a method of reading directories to get the UNICODE file ... >> I have been having distinct trouble creating file names in PERL ...
    (comp.lang.perl.misc)
  • Beta Release: LocaleExlplorer
    ... It also builds only in Unicode mode, and therefore requires you install the VS6 Unicode ... The goal here is to give you the necessary code templates for doing localized ... The Web pages are the remaining documentation. ... MVP Tips: http://www.flounder.com/mvp_tips.htm ...
    (microsoft.public.vc.mfc)
  • Re: About CRuntimeClass::m_lpszClassName
    ... I have often wondered why it is such a burden on the documentation people to include the ... data type of a declaration in the documentation. ... Because the value is an LPCSTR, the constructor for a Unicode ...
    (microsoft.public.vc.mfc)
  • Re: Debugging
    ... execution should be a doddle ...provided they come from the same vendor ... cut&paste from vendor A's documentation to vendor B's interpreter will ... Unicode values ... APLX, and the other major APL vendors. ...
    (comp.lang.apl)