Файлы инициализации. Структура файла инициализации, страница 4

значения ключа Ticks, после чего окно перерисовывается. Результаты тестирования показаны на рис. 20.1.

Of.   \Jocel-eources\chap20\20-01.txt

GetPrivateProfileSection                4 Windows 98   + Windows 2000

Описание

Функция GetPrivateProfileSection заполняет предоставляемый буфер строками присвоения значений ключам из указанного раздела в INI-файле. Строки присвоения значений ключам выглядят следующим образом: клю-ч=значение. Таким образом, буфер будет содержать целый ряд последовательно расположенных и завершающихся нулевым символом строк присвоения значений ключам. Последняя строка в буфере завершается двумя нулевыми символами. В Windows 9.x размер считываемого раздела не может превышать 32 Кб. Во время копирования в буфер строк присвоения значений ключам Windows автоматически блокирует все обновления файла инициализации.

Синтаксис

DWORD GetPrivateProfileSection (LPCTSTR IpszSectionName, LPCTSTR IpReturnBuffer, DWORD dwcBuffer, LPCTSTR Ipszlni Hie Name)

Параметры

IpszSectionName

LPCTSTR: Указатель на строку, завершающуюся нулевым символом и содержащую имя раздела.

IpReturnBuffer

LPCTSTR: Указатель на буфер, в который поступает содержимое раздела.

dwcBuffer

DWORD: Размер буфера IpReturnBuffer, в который поступают данные.

Ipszlni Hie Name

LPCTSTR: Указатель на строку, завершающуюся нулевым символом и содержащую имя приватного профильного файла. Если параметр IpszIniFileName не содержит полностью уточненный путь к данному файлу, Windows выполняет поиск INI -файла в каталоге Windows.

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

DWORD: Количество символов, скопированных в буфер, за исключением завершающего нулевого символа. Если места для хранения всех строк присвоения значений ключам данного раздела оказывается недостаточно, возвращается значение dwcBuffer-2.