WriteProfileString

【勇芳软件工作室】汉化HomePreviousNext

WriteProfileString函数将一个字符串复制到WIN.INI文件的指定部分。

此函数用于与16位基于Windows的应用程序兼容。基于Win32的应用程序应该将初始化信息存储在注册表中。

BOOL WriteProfileString(

LPCTSTR 【lpAppName】,//指向节名的指针
LPCTSTR 【lpKeyName】,//指向键名的指针
LPCTSTR 【lpString】//指向要写入的字符串的指针
); 

参数

【lpAppName】

指向一个以null结尾的字符串,指定要复制字符串的部分。如果该部分不存在,则创建它。该部分的名称不区分大小写;字符串可以是大写和小写字母的任何组合。

【lpKeyName】

指向一个以null结束的字符串,其中包含与该字符串关联的键。如果该键在指定的部分不存在,则创建它。如果此参数为NULL,整个部分(包括该部分中的所有条目)将被删除。

【lpString】

指向要写入文件的以null结尾的字符串。如果此参数为NULL,则【lpKeyName】参数指向的键将被删除。

Windows 95:此平台不支持将TAB(\\ t)字符用作此参数的一部分。

返回值

如果函数成功将该字符串复制到WIN.INI文件,则返回值不为零。

如果函数失败,或者如果它刷新WIN.INI的缓存版本,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

Windows 95:

Windows 95保留WIN.INI的缓存版本,以提高性能。如果所有三个参数都为NULL,则该函数将刷新缓存。刷新缓存后,函数总是返回FALSE,无论刷新是成功还是失败。

WIN.INI文件中的一个部分必须具有以下格式:

[【section】]
【键】=【串】
.
.
.

Windows NT:

Windows NT将大多数.INI文件引用映射到注册表,使用以下注册表项下定义的映射:

HKEY_LOCAL_MACHINE\软件\微软\
Windows NT\CurrentVersion\IniFileMapping

当映射操作时,WriteProfileString函数将信息写入注册表,而不是初始化文件;存储位置的变化对功能的行为没有影响。

Win32配置文件功能(Get/WriteProfile*Get/WritePrivateProfile*)使用以下步骤来定位初始化信息:

1.在注册表中的初始化文件的名称,说myfile.ini,在IniFileMapping下:

HKEY_LOCAL_MACHINE\软件\微软\
Windows NT\CurrentVersion\IniFileMapping\myfile.ini

2.查看【lpAppName】指定的部分名称。这将是myfile.ini下的命名值,或myfile.ini的子项,否则将不存在。

3.如果【lpAppName】指定的节名称是myfile.ini下的一个命名值,那么该值指定注册表中的哪个位置可以找到该节的键。

4.如果【lpAppName】指定的部分名称是myfile.ini的子项,则该子项下的命名值将指定注册表中的哪个部分的键。如果您要查找的密钥不存在作为命名值,那么将会有一个未命名的值(显示为“< No Name >”),指定注册表中的默认位置,您将在其中找到密钥。

5.如果由【lpAppName】指定的段名称不存在作为命名值或myfile.ini下的子项,则在myfile下将显示一个未命名的值(如“< No Name >”)) .ini,它指定注册表中的默认位置,您可以在其中找到该部分的键。

6.如果没有myfile.ini的子项,或者没有条目名称的条目,那么在磁盘上查找实际的myfile.ini并读取其内容。

当查看注册表中指定其他注册表位置的值时,有几个前缀可以更改ini文件映射的行为:

! - 这个字符强制所有的写入都到磁盘上的注册表和.INI文件。

# - 当新用户在安装后首次登录时,此字符会使注册表值设置为Windows 3.1 .INI文件中的值。

@ - 如果在注册表中找不到所请求的数据,则此字符可防止任何读取到磁盘上的.INI文件。

USR: - 此前缀代表HKEY_CURRENT_USER,前缀后面的文本与该键相关。

SYS: - 此前缀代表HKEY_LOCAL_MACHINE \\ SOFTWARE,前缀后的文本与该键相关。

也可以看看

GetProfileString, WritePrivateProfileString