读取INI配置文件GetProfileString和GetPrivateProfileString参数说明和示例

winapi函数介绍

GetPrivateProfileString

VB声明
Declare Function GetPrivateProfileString& Lib "kernel32" Alias "GetPrivateProfileStringA" (ByVal lpApplicationName As String, ByVal lpKeyName As String, ByVal lpDefault As String, ByVal lpReturnedString As String, ByVal nSize As Long, ByVal lpFileName As String)
说明
为初始化文件中指定的条目取得字串
返回值
Long，复制到lpReturnedString缓冲区的字节数量，其中不包括那些NULL中止字符。如lpReturnedString缓冲区不够大，不能容下全部信息，就返回nSize-1（若lpApplicationName或lpKeyName为NULL，则返回nSize-2）
参数表
参数	类型及说明
lpApplicationName	String，欲在其中查找条目的小节名称。这个字串不区分大小写。如设为vbNullString，就在lpReturnedString缓冲区内装载这个ini文件所有小节的列表
lpKeyName	String，欲获取的项名或条目名。这个字串不区分大小写。如设为vbNullString，就在lpReturnedString缓冲区内装载指定小节所有项的列表
lpDefault	String，指定的条目没有找到时返回的默认值。可设为空（""）
lpReturnedString	String，指定一个字串缓冲区，长度至少为nSize
nSize	Long，指定装载到lpReturnedString缓冲区的最大字符数量
lpFileName	String，初始化文件的名字。如没有指定一个完整路径名，windows就在Windows目录中查找文件
注解
如lpKeyName参数为vbNullString，那么lpReturnedString缓冲区会载入指定小节所有设置项的一个列表。每个项都用一个NULL字符分隔，最后一个项用两个NULL字符中止。也请参考GetPrivateProfileInt函数的注解
其他
在vb的api文本查看器中复制的声明为：Declare Function GetPrivateProfileString Lib "kernel32" Alias "GetPrivateProfileStringA" (ByVal lpApplicationName As String, ByVal lpKeyName As Any, ByVal lpDefault As String, ByVal lpReturnedString As String, ByVal nSize As Long, ByVal lpFileName As String) As Long

WritePrivateProfileString

VB声明
Declare Function WritePrivateProfileString& Lib "kernel32" Alias "WritePrivateProfileStringA" (ByVal lpApplicationName As String, ByVal lpKeyName As Any, ByVal lpString As String, ByVal lpFileName As String)
说明
在初始化文件指定小节内设置一个字串
返回值
Long，非零表示成功，零表示失败。会设置GetLastError
参数表
参数	类型及说明
lpApplicationName	String，要在其中写入新字串的小节名称。这个字串不区分大小写
lpKeyName	Any，要设置的项名或条目名。这个字串不区分大小写。用vbNullString可删除这个小节的所有设置项
lpString	String，指定为这个项写入的字串值。用vbNullString表示删除这个项现有的字串
lpFileName	String，初始化文件的名字。如果没有指定完整路径名，则windows会在windows目录查找文件。如果文件没有找到，则函数会创建它
其他
在vb的api文本查看器里复制的声明如下： Declare Function WritePrivateProfileString Lib "kernel32" Alias "WritePrivateProfileStringA" (ByVal lpApplicationName As String, ByVal lpKeyName As Any, ByVal lpString As Any, ByVal lpFileName As String) As Long

例子

Option Explicit


Private Declare Function GetPrivateProfileString Lib "kernel32" Alias "GetPrivateProfileStringA" (ByVal lpApplicationName As String, ByVal lpKeyName As Any, ByVal lpDefault As String, ByVal lpReturnedString As String, ByVal nSize As Long, ByVal lpFileName As String) As Long
Private Declare Function WritePrivateProfileString Lib "kernel32" Alias "WritePrivateProfileStringA" (ByVal lpApplicationName As String, ByVal lpKeyName As Any, ByVal lpString As Any, ByVal lpFileName As String) As Long
Private Sub Form_Load()
     Dim Ret As String, NC As Long
 
    WritePrivateProfileString App.Title, "KeyName", "This is the value", "c:\test.ini"
      WritePrivateProfileString App.Title, "Connection", "server = "" ", "c:\test.ini"
  
    Ret = String(255, 0)
  
    NC = GetPrivateProfileString(App.Title, "KeyName", "Default", Ret, 255, "C:\test.ini")
 
    If NC <> 0 Then Ret = Left$(Ret, NC)
 
    MsgBox Ret
    Ret = String(255, 0)
    NC = GetPrivateProfileString(App.Title, "Connection", "Default", Ret, 255, "C:\test.ini")
   
    If NC <> 0 Then Ret = Left$(Ret, NC)
   
    MsgBox Ret
   
End Sub