Append an entry to end of file.

DWORD Cfg(
    CFGFILE cFile,

    int*    n,

    LPCSTR  pPath,

    LPCSTR  pArgs,

    LPCSTR  pOpts,

    LPCSTR  pComment,

    BOOL    bEnabled
); 

Parameters

cFile

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

n

(out) Pointer to a int that is set to the number of the inserted line in the file.

pPath

(in) Full path to application to load.

pArgs

(in) Arguments for the application to load. It should not contain quotes surrounding the arguments.

pOpts

(in) The options for the loader.

pComment

(in) The comment, without leading semicolon.

bEnabled

(in) True for enabled, FALSE for skip during load.

Return values

ECFG_OK for success or an error code on failure.

Remarks

Appends a new line to the end of the file and returns the number of that line via an output parameter.

Errors

ECFG_BADCFGFILE

File handle out of range or invalid

ECFG_WRONGFILETYPE

The file handle does not point to a load file