dlm_FileWrite()

Writes a single DLM event to the file.

#include "dlmfile.h"

DlmResult dlm_FileWrite
    (
        DlmFileId  id,
        DlmEvent   event
    );

dlm_FileWrite() writes a single DLM event to the file.

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

• dlm_ERROR_FAILURE_WRITING_FILE
• dlm_ERROR_INVALID_COMMAND
• dlm_ERROR_INVALID_ID
• dlm_ERROR_INVALID_PARAMETERS

dlm_FileRead()
dlm_FileReadEvents()
dlm_FileReleaseEvent()

if ((result = dlm_FileWrite(id, event)) < 0)
{
    printf("Error: Failure writing: %s.\n", dlm_ErrorMessage(result));
}
else
{
    /* do something */
}