lgo_SaveConfiguration()

Save a protocol configuration to file.

#include "laygo.h"

LResult lgo_SaveConfiguration
    (
        LFileName      fileName,
        LProtocol      protocol,
        LCtlBuffer     buffer,
        LBufferSize    size
    );

lgo_SaveConfiguration() writes a protocol configuration to a file. If the file exists, the configuration is placed in the file. If the file does not exist, it is created. The extension ".cfg" is automatically added to the file name. The configuration can be read from the file using lgo_ConfigureStack() or lgo_LoadConfiguration().

If successful, lgo_SaveConfiguration() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• lgo_ERROR_INVALID_OUTPUT_BUFFER
• lgo_ERROR_OUT_OF_MEMORY
• lgo_ERROR_UNKNOWN_PROTOCOL
• lgo_ERROR_CONFIGURATION_FILE_READ_ERROR
• lgo_ERROR_CONFIGURATION_FILE_WRITE_ERROR
• lgo_ERROR_CONFIGURATION_FILE_NOT_FOUND
• lgo_ERROR_CONFIGURATION_NOT_DEFINED

lgo_ConfigureStack()
lgo_LoadConfiguration()

char        buffer[128];
LResult     result;

result = lgo_GetConfiguration(cid,
                    buffer,
                    (LBufferSize) sizeof(buffer));

if (result > 0)
{
    result = lgo_SaveConfiguration(fileName,
                    lgo_Protocol(cid),
                    buffer,
                    (LBufferSize) result));
}

return (result);