Add a section.

DWORD CfgSectionAdd(
    CFGFILE cFile,

    LPCSTR  szSection
); 

Parameters

cFile

(in) File handle retrieved by previous CfgFileOpen with argument CFG_SECTION as type.

szSection

(in) Name of section to add.

Return values

ECFG_OK for success or an error code on failure.

Remarks

Adds an empty section at the end of the file.

Errors

ECFG_BADCFGFILE

File handle out of range or invalid

ECFG_MEM

There is not enough memory to expand the buffer

ECFG_ALREADY

A section with this name already exists

ECFG_PARSEWARN

The section name is invalid

ECFG_WRONGFILETYPE

Wrong file type