Функция GetPrivateProfileSectionNames (winbase.h)

Статья
08/27/2023

Извлекает имена всех разделов в файле инициализации.

Примечание Эта функция предоставляется только для обеспечения совместимости с 16-разрядными приложениями Windows. Приложения должны хранить сведения об инициализации в реестре.

Синтаксис

DWORD GetPrivateProfileSectionNames(
  [out] LPTSTR  lpszReturnBuffer,
  [in]  DWORD   nSize,
  [in]  LPCTSTR lpFileName
);

Параметры

[out] lpszReturnBuffer

Указатель на буфер, получающий имена разделов, связанных с именованным файлом. Буфер заполняется одной или несколькими строками, заканчивающихся значением NULL; за последней строкой следует второй пустой символ.

[in] nSize

Размер буфера, на который указывает параметр lpszReturnBuffer , в символах.

[in] lpFileName

Имя файла инициализации. Если этот параметр имеет значение NULL, функция выполняет поиск в файле Win.ini. Если этот параметр не содержит полный путь к файлу, система выполняет поиск файла в каталоге Windows.

Возвращаемое значение

Возвращаемое значение указывает количество символов, скопированных в указанный буфер, не включая завершающий символ NULL . Если буфер недостаточно велик для хранения всех имен разделов, связанных с указанным файлом инициализации, возвращаемое значение равно размеру, заданному параметром nSize минус два.

Система сопоставляет большинство .ini ссылок на файлы с реестром с помощью сопоставления, определенного в следующем разделе реестра:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\IniFileMapping

Это сопоставление вероятно, если приложение изменяет файлы инициализации системных компонентов, такие как Control.ini, System.ini и Winfile.ini. В таких случаях функция получает сведения из реестра, а не из файла инициализации; Изменение расположения хранилища не влияет на поведение функции.

Функции профилей используют следующие действия для поиска сведений об инициализации.

Найдите в реестре имя файла инициализации в разделе IniFileMapping .
Найдите имя раздела, указанное в параметре lpAppName. Это будет именованное значение в ключе, которое имеет имя файла инициализации, или подраздел с этим именем, или имя не будет существовать как значение или подраздел.
Если имя раздела, указанное lpAppName , является именованным значением, то это значение указывает, где в реестре будут находиться ключи для раздела.
Если имя раздела, указанное в lpAppName , является подразделом, то именованные значения в этом подразделе укажите, где в реестре будут находиться ключи для раздела. Если ключ, который вы ищете, не существует как именованное значение, будет неименованное значение (отображается как <Без имени>), указывающее расположение по умолчанию в реестре, где будет находиться ключ.
Если имя раздела, указанное в параметре lpAppName , не существует в качестве именованного значения или подраздела, будет указано неименованное значение (без <имени>), указывающее расположение по умолчанию в реестре, где будут находиться ключи для раздела.
Если для имени раздела нет подраздела или записи, найдите фактический файл инициализации на диске и прочитайте его содержимое.

При просмотре значений в реестре, указывающих другие расположения реестра, существует несколько префиксов, которые изменяют поведение сопоставления файлов .ini:

! — этот символ заставляет все операции записи отправляться как в реестр, так и в файл .ini на диске.
# — этот символ приводит к тому, что для параметра реестра будет задано значение в файле .ini Windows 3.1, когда новый пользователь впервые входит в систему после установки.
@ — этот символ не позволяет выполнять операции чтения в .ini файл на диске, если запрошенные данные не найдены в реестре.
USR: этот префикс означает HKEY_CURRENT_USER, а текст после префикса относится к этому ключу.
SYS: этот префикс означает HKEY_LOCAL_MACHINE\SOFTWARE, а текст после префикса относится к этому ключу.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

GetPrivateProfileSection

WritePrivateProfileSection