共用方式為


GetProfileSectionA 函式 (winbase.h)

擷取 Win.ini 檔案指定區段的所有索引鍵和值。

注意 此函式僅適用於與16位 Windows 型應用程式的相容性。 應用程式應該將初始化資訊儲存在登錄中。
 

語法

DWORD GetProfileSectionA(
  [in]  LPCSTR lpAppName,
  [out] LPSTR  lpReturnedString,
  [in]  DWORD  nSize
);

參數

[in] lpAppName

Win.ini 檔案中的區段名稱。

[out] lpReturnedString

緩衝區的指標,接收與具名區段相關聯的索引鍵和值。 緩衝區會填入一或多個以 Null 結尾的字串;最後一個字串後面接著第二個 Null 字元。

[in] nSize

lpReturnedString 參數所指向的緩衝區大小,以字元為單位。

配置檔區段大小上限為 32,767 個字元。

傳回值

傳回值會指定複製到指定緩衝區的字元數,不包括終止 Null 字元。 如果緩衝區不夠大,無法包含與具名區段相關聯的所有索引鍵和值,則傳回值等於 nSize 減 2 所指定的大小。

備註

傳回索引鍵和值的格式是一或多個以 Null 結尾的字串,後面接著最後的 Null 字元。 每個字串都有下列形式: 索引鍵=字串

GetProfileSection 函式不區分大小寫;字串可以是大寫和小寫字母的組合。

此作業不可部分完成;當區段的索引鍵和值複製到緩衝區時,不允許更新 Win.ini 檔案。

Windows Server 2003 和 Windows XP/2000: 對配置檔函式的呼叫可能會對應至登錄,而不是對應至初始化檔案。 當登入指定下列機碼下的初始化檔案和區段時,就會發生此對應: HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\IniFileMapping

當作業已對應時, GetProfileSection 函式會從登錄擷取資訊,而不是從初始化檔案擷取資訊;儲存位置中的變更不會影響函式的行為。

設定檔案函式會使用下列步驟來找出初始化資訊:

  1. 在登錄中尋找 IniFileMapping 機碼下初始化檔案的名稱。
  2. 尋找 lpAppName 所指定的區段名稱。 這會是索引鍵底下的具名值,其名稱為初始化檔的名稱,或是具有此名稱的子機碼,或名稱不存在為值或子機碼。
  3. 如果 lpAppName 指定的區段名稱是具名值,則該值會指定登錄中的位置,您會找到區段的機碼。
  4. 如果 lpAppName 指定的區段名稱是子機碼,則該子機碼下的具名值會指定登錄中的位置,您會找到區段的機碼。 如果您要尋找的機碼不存在為具名值,則會有未命名的值, (顯示為 <[無名稱> ]) ,指定您在登錄中找到密鑰的預設位置。
  5. 如果 lpAppName 指定的區段名稱不存在為具名值或子機碼,則會有未命名的值 (顯示為 <[無名稱> ]) ,指定您在登錄中找到區段索引鍵的預設位置。
  6. 如果沒有區段名稱的子機碼或專案,請尋找磁碟上的實際初始化檔案,並讀取其內容。
在登錄中查看指定其他登錄位置的值時,有數個前置詞會變更 .ini 檔案對應的行為:
  • ! - 此字元會強制所有寫入至登錄和磁碟上的 .ini 檔案。
  • # - 當新使用者第一次在安裝之後登入時,此字元會使登錄值設定為 Windows 3.1 .ini 檔案中的值。
  • @ - 如果登錄中找不到要求的數據,此字元可防止任何讀取移至磁碟上的 .ini 檔案。
  • USR: - 此前置詞代表 HKEY_CURRENT_USER,且前置詞之後的文字相對於該索引鍵。
  • SYS:- 此前置詞代表 HKEY_LOCAL_MACHINE\SOFTWARE,而前置詞之後的文字則相對於該索引鍵。

注意

winbase.h 標頭會將 GetProfileSection 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

GetPrivateProfileSection

WriteProfileSection