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

Функция

Назначение

GetPrivateProfilelnt

Осуществляет выборку целого значения ключа из приватного файла инициализации

GetPrivateProfileSection

Осуществляет выборку всех ключей и значений из раздела в приватном файле инициализации

GetPrivateProfileSectionNames

Осуществляет выборку всех имен значений из приватного файла инициализации

GetPrivateProfileString

Осуществляет выборку строкового значения ключа из приватного файла инициализации

GetPrivateProfileStruct

Осуществляет выборку данных ключа из приватного файла инициализации

GetProfitelnt

Осуществляет выборку целого значения из файла WIN.INI

GetProfileSection

Осуществляет выборку всех ключей и значений из раздела в файле WIN.INI

GetProfileString

Осуществляет выборку строкового значения из файла WIN.INI

WritePrivateProfileSection

Сохраняет заданные ключи и значения в разделе приватного файла инициализации

WrttePrivateProfileString

Сохраняет строковое значение в ключе приватного файла инициализации

WrttePri vateProf ileStruct

Копирует данные в ключ приватного файла инициализации

WriteProfiteSection

Сохраняет весь раздел со всеми ключами и значениями в файле  WIN.INI

WriteProfiteString

Срхраняет строковое значение в ключе файла WIN.INI

GetPrivateProfilelnt                     • Windows 98   * Windows 2000

Описание

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

Синтаксис

UINT GetPrivateProfileInt(LPCTSTR IpszSectionName, LPCTSTR IpszKeyName, INT dwDefault, LPCTSTR IpszIniFileName)

Параметры

IpszSectionName

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

IpszKeyName

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

dwDefault

INT: Используемое по умолчанию значение, возвращаемое в случае, если • указанный ключ не найден.

IpszIniFHeNoHM

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

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

UINT: Целое значение, если ключ найден в указанном разделе INI-файла. Если ключ не найден, возвращается используемое по умолчанию значение параметра dwDefault. А если значение ключа оказывается меньше нуля, вместо него возвращается 0.

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

winbase.h

См. также

GetProfilelnt, WritePrivateProfileString, GetPrivateProfileString.

Пример

В приведенном ниже примере значение ключа Ticks из раздела TestSection файла YOUR.INI отображается при каждой обрисовке окна на экране. При выборе oifuHtr 'Test! количествб временных меток записывается в виде