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

IpStruct

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

uSizeStfuct Ipszfile

UINT: Размер в байтах буфера, на который указывает параметр IpStruct LPCTSTR: Указатель на строку, завершающуюся нулевым символом и содержащую имя файла инициализации. Если этот параметр не содержит полностью уточненное имя пути к данному файлу, тогда Windows осуществит поиск 1NI -файла в каталоге Windows.

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

BOOL Если выполнение рассматриваемой функции оказывается успешным, возвращается значение TRUE. В противном случае возвращается значение FALSE.

Включаемый файл

winbase.h

См. также

WritePrivateProfileStruct.

GetProfilelnt                             «• Windows 98   • Windows 2000

Описание

Функция GetProfilelnt возвращает целое значение, связанное с конкретным ключом из указанного радела файла WIN.INI.

Синтаксис

UINT GetProfileInt(LPCTSTR IpszSectionName, LPCTSTR IpszKeyName, INT dwDefaulf)

Параметры

IpszSecrionName

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

IpszKeyName

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

dw Default

INT: Значение, возвращаемое в случае, если ключ в указанном разделе файла WIN.INI не найден.

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

UINT: Если ключ в указанном разделе файла WIN.INI найден, возвращается целое значение этого ключа. Если же ключ не найден, возвращается устанавливаемое по умолчанию значение dw Default. Если значение ключа меньше нуля, возвращается 0.

Включаемый файл

winbase.h

См. также

GetPrivateProfilelnt, WriteProfileString.

Пример

Когда пользователь выбирает в приведенном ниже примере опцию Test!, считывается и отображается знак денежной единицы и соответствующий ряд цифр суммы.

См.    \local-sources\chap20\20-05. txt

GetProfileSection                       • Windows 98   • Windows 2000

Описание

Функция GetProfileSection заполняет предоставляемый буфер строками присвоения значений ключам из указанного раздела в файле WIN.INI. Строки присвоения значений ключам представлены в виде ключ=зпачение. Таким образом, буфер будет содержать целый ряд последовательно расположенных и завершающихся нулевым символом строк присвоения значений ключам. Последняя строка в буфере завершается дополнительным

нулевым символом. В Windows 95 размер считываемого раздела не может превышать 32 Кб.

Синтаксис

DWORD GetProfileSection(LPCTSTR IpszSectionName, LPCTSTR IpszReturnBuffer, DWORD dwBuffer)

Параметры

IpszSectionName

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

IpszReturn Buffer

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

dwBuffer

DWORD: Размер буфера.

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

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

Включаемый файл

winbase.h

См. также

GetPrivateProfileSection, WritePrivateProfileSection.

Пример

На рис. 20.3. показан результат выполнения тестовой программы, которая осуществляет выборку строк присвоения значений ключам из раздела портов в файле WIN.INI.

См.    \local-sources\chap20\20-06. txt

GetProfileString                        • Windows 98   • Windows 2000

Описание

Функция GetProfileString возвращает строковое значение, связанное с конкретным ключом из указанного раздела в файле WIN.INI.

Синтаксис

DWORD GetProfileString(LPCTSTR IpszSectionName, LPCTStR IpszKeyName, LPCTSTR IpszDefaultValue, LPCTSTR IpszReturnBuffer, DWORD dwBuffer)

Параметры

IpszSectionName

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

IpszKeyName

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

IpszDefault Value

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

IpszReturn Buffer

LPCTSTR: Указатель на буфер, который будет заполняться системой. В типичном случае возврата значения единственного ключа этот буфер будет содержать единственную строку, завершающуюся нулевым символом. А в случае запроса имен разделов или ключей из файла WIN.INI (т.е. при указании значения NULL для параметра IpszSectionName или IpszKeyName,