Microsoft KB Archive/69752

{|
 * width="100%"|

HOWTO: Use Quoted Strings with Profile String Functions

 * }

Q69752

-

The information in this article applies to:


 * Microsoft Windows Software Development Kit (SDK)
 * Microsoft Win32 Application Programming Interface (API)

-

SUMMARY
Microsoft Windows provides profile files which are a mechanism for an application to store configuration about itself. The WIN.INI file is the system profile file in which Windows stores configuration information about itself. In versions of Windows prior to version 3.0, applications also stored configuration information in the WIN.INI file. Windows 3.0 introduced private profile files, which can store application-specific information.

An application can retrieve information from a profile file by calling the GetProfileString or GetPrivateProfileString function. If the profile file associates the specified lpKeyName value with a string that is delimited by quotation marks, Windows discards the quotation marks when it copies the associated string into the application- provided buffer.

For example, if the following entry appears in the profile file:

  [application name]           [application name] keyname = 'string'    or     keyname = &quot;string&quot; The GetPrivateProfileString and GetProfileString functions read the string value and discard the quotation marks.

MORE INFORMATION
This behavior allows spaces to be put into a string. For example, the profile entry

"keyname = string" returns the string without a leading space, whereas

  keyname = ' string'     or     keyname = &quot; string&quot; returns the string with a leading space.

Doubling quotation marks includes quotation marks in the string. For example:

  keyname = string    or     keyname = &quot;&quot;string&quot;&quot; returns the string with its quotation marks -- 'string' or &quot;string&quot;.

Additional query words:

Keywords : kbOSWinNT kbOSWin2000 kbSDKWin32 kbGrpDSUser kbOSWin

Issue type : kbhowto

Technology : kbAudDeveloper kbSDKSearch kbWin32sSearch kbWin32API kbWinSDKSearch