Windows API Guide: waveOutGetNumDevs Function

---

Declare Function WriteProfileString Lib "kernel32.dll" Alias "WriteProfileStringA" (ByVal lpszSection As String, ByVal lpszKeyName As String, ByVal lpszString As String) As Long

Platforms: Win 32s, Win 95/98, Win NT

WriteProfileString sets a value inside of the WIN.INI file. This function can also be used to set numerical values if they are in string form, for example using "1" to represent the number 1. If the section or value does not exist, it will be created. Note that, since Windows normally handles the WIN.INI file by iself, extreme care should be taken when writing directly to it. This function if basically a watered-down version of WritePrivateProfileString because, unlike this function, it works with any INI file. The function returns 0 if an error occurs, or a non-zero value if successful. Note that INI file support is only provided in Windows for backwards compatibility; using the registry to store information is preferred.

lpszSection

The section of WIN.INI to write to.

lpszKeyName

The name of the value to set.

lpszString

The string to set as the value.

Example:

' Set the "Wallpaper" setting in the [Desktop] section of WIN.INI ' to C:\Windows\Clouds.bmp. ' WARNING: Use extreme caution when editing the WIN.INI file, because writing bad data to ' it could have unpredictable and disasterous results to the system! Dim retval As Long  ' return value ' Set the value. retval = WriteProfileString("Desktop", "Wallpaper", "C:\Windows\Clouds.bmp")

See Also: GetProfileString, WritePrivateProfileString
Category: INI Files

Go back to the alphabetical Function listing.
Go back to the Reference section index.

---

This page is copyright © 2000 Paul Kuliniewicz. Copyright Information.
Go back to the Windows API Guide home page.
E-mail: [e-mail] Send Encrypted E-Mail
This page is at http://www.vbapi.com/ref/w/writeprofilestring.html