2024年4月2日发(作者:)

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