複製鏈接
請複製以下鏈接發送給好友

GetProfileString

鎖定
GetProfileString,計算機語言C/C++的函數。在WIN32 API中,功能是從win.ini文件中讀取指定段和鍵的值;在CWinApp中,功能是讀出指定段名、指定入口的值。
中文名
GetProfileString
屬    性
函數
詞    性
名詞
功    能
讀出指定段名、指定入口的值等

目錄

  1. 1 用法
  2. 聲明
  3. 説明
  4. 註解
  1. 返回值
  2. 説明
  3. 示例
  4. 2 App
  1. 返回值
  2. 參數
  3. 示例
  4. 3 VB聲明

GetProfileString用法

GetProfileString聲明

Declare Function GetProfileString Lib "kernel32" Alias "GetProfileStringA" (ByVal lpAppName As String, ByVal lpKeyName As String, ByVal lpDefault As String, ByVal lpReturnedString As String, ByVal nSize As Long) As Long

GetProfileString説明

為win.ini初始化文件中指定的條目取得字串則返回(nSize-2)Long,裝載到lpReturnedString緩衝區的最大字符數

GetProfileString註解

CWinApp成員函數
CWinApp::GetProfileString
CString GetProfileString( LPCTSTR lpszSection, LPCTSTR lpszEntry, LPCTSTR lpszDefault = NULL );

GetProfileString返回值

返回值是應用程序的.INI文件中的字符串,如果找不到該字符串,則為lpszDefault。框架支持的字符串最大長度為_MAX_PATH。如果lpszDefault為NULL,則返回值是一個空字符串
參數: lpszSection 指向一個以null結尾的字符串,指定了包含入口的部分。

GetProfileString説明

調用這個函數以獲得與應用程序的註冊表或.INI文件中指定部分的入口相關的字符串。
這些入口按照如下方式保存:
·Windows NT 該值保存在註冊表中
·Windows 3.X 該值保存在WIN.INI文件中
·Windows 95 該值保存在WIN.INI的緩衝版本中

GetProfileString示例

CString strSection = "My Section";
CString strStringItem = "My String Item";
CString strIntItem = "My Int Item";
CWinApp* pApp = AfxGetApp();
pApp->WriteProfileString(strSection, strStringItem, "test");
CString strValue;
strValue = pApp->GetProfileString(strSection, strStringItem);
ASSERT(strValue == "test");
pApp->WriteProfileInt(strSection, strIntItem, 1234);
int nValue;
nValue = pApp->GetProfileInt(strSection, strIntItem, 0);
ASSERT(nValue == 1234);

GetProfileStringApp

CString GetProfileString( LPCTSTR lpszSection, LPCTSTR lpszEntry, LPCTSTR lpszDefault = NULL );

GetProfileString返回值

返回值是應用程序的.INI文件中的字符串,如果找不到該字符串,則為lpszDefault。框架支持的字符串最大長度為_MAX_PATH。如果lpszDefault為NULL,則返回值是一個空字符串。

GetProfileString參數

lpszSection
指向一個以null結尾的字符串,指定了包含入口的部分。
lpszEntry
指向一個以null結尾的字符串,其中包含了要獲取字符串的入口。這個值不能為NULL。
lpszDefault
指向給定入口的缺省字符串值,當初始化文件中找不到入口時使用該值。

GetProfileString示例

CString str;
str = GetProfileString("SectionName", "EntryName", "defaultValue");
執行後str == "value", 否則str=="defaultValue" 。

GetProfileStringVB聲明

Declare Function GetProfileString Lib "kernel32" Alias "GetProfileStringA" (ByVal lpAppName As String, ByVal lpKeyName As String, ByVal lpDefault As String, ByVal lpReturnedString As String, ByVal nSize As Long) As Long
説明
為win.ini初始化文件中指定的條目取得字串
返回值
Long,複製到lpReturnedString緩衝區的字節數量,其中不包括那些NULL中止字符。如lpReturnedString緩衝區不夠大,不能容下全部信息,就返回nSize-1(若lpAppName或lpKeyName為NULL,則返回nSize-2)
參數表
參數
類型及説明
lpAppName
String,要在其中查找條目的小節名。這個字串不區分大小寫。如果為vbNullString,則在lpReturnedString緩衝區裝載這個.ini文件的所有小節的一個列表
lpKeyName
String,欲獲取的項名或條目名。這個字串不區分大小寫。如果為vbNullString,則在lpReturnedString緩衝區裝載指定小節內所有項的一個列表
lpDefault
String,指定條目未找到時返回的默認值。可設為空("")
lpReturnedString
String,指定一個預先初始化好的字串緩衝區,長度至少為nSize個字符
nSize
Long,裝載到lpReturnedString緩衝區的最大字符數
註解
如lpKeyName參數為零,那麼lpReturnedString緩衝區會載入指定小節內所有設置項的一個列表。每個項都用一個NULL字符分隔,最後那個項用兩個NULL字符中止