IniGetStr12

Извлекает текстовое значение параметра.

char IniGetStr12A(
    char* Buf,
    size_t Bufsz,
    const char* ParamName,
    char* Dest,
    size_t* DestSz,
    const PINISECTION Section
);
char IniGetStr12W(
    wchar_t* Buf,
    size_t Bufsz,
    const wchar_t* ParamName,
    wchar_t* Dest,
    size_t* DestSz,
    const PINISECTION Section
);

Параметры

Buf [вх]
Блок памяти с загруженным в него содержимым ini файла.
Bufsz [вх] Размер этого блока (символов).
ParamName [вх] Имя параметра.
Dest
[вых] Адрес буфера - приёмника значения параметра. Допустимо задать = 0, в таком случае функция вернёт в DestSz необходимый размер буфера.
DestSz
[вх/вых] Размер буфера Dest. Возвращает число символов, записанных в Dest, с учётом завершающего нуля.
Section [вх] Адрес структуры INISECTION для выбора целевой группы параметров в ini файле. Допустимо = 0 для доступа к параметрам, не относящимся к какой либо группе.

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

0 при успехе.
1 при успехе, но в случае если размера буфера не хватило для сохранения всего значения параметра.
Или код ошибки.

Заметки

Несколько иначе воспринимают пустую секцию: всегда возврат = 2;
Допустимо задать Section = 0 для доступа параметрам, не относящимся к какой либо группе, однако для более высокой производительности рекомендуется получить указатель на "безымяную" секцию и использовать его.

Внимание!

Требует линковки с msvcrt! Имеет проблемы с современными компиляторами от Microsoft.

Быстрая справка

ОС Требует наличие стандартной библиотеки Си
DLL 2fapShare.dll
Библиотека 2fapShare.lib
Заголовок ini.h

Смотри также

Работа с ini файлами
INISECTION, IniCreateSection, IniDelParam, IniDelSection, IniGetNum, IniGetStr, IniSetSection, IniSetNum, IniSetStr