dlm_FileOpen()

Opens a DLM file for reading or writing.

#include "dlmfile.h"

DlmResult dlm_FileOpen
    (
        DlmFileName  fileName,
        DlmFileMode  fileMode,
        DlmFileId *  id
    );

dlm_FileOpen() opens a DLM file for reading or writing.

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

• dlm_ERROR_FAILURE_OPENING_FILE
• dlm_ERROR_FAILURE_WRITING_FILE
• dlm_ERROR_FILE_NOT_FOUND
• dlm_ERROR_INVALID_FILE
• dlm_ERROR_INVALID_PARAMETERS
• dlm_ERROR_OUT_OF_MEMORY

dlm_FileClose()
dlm_FileRead()
dlm_FileWrite()

if ((result = dlm_FileOpen(fileName, dlm_FILE_MODE_WRITE, &id)) < 0)
{
    printf("Error: Failure opening file for writing: %s.\n", dlm_ErrorMessage(result));
}
else
{
    /* do something */

    if ((result = dlm_FileClose(id) < 0)
    {
        printf("Error: Failure closing file: %s.\n", dlm_ErrorMessage(result));
    }
    else
    {
        printf("File closed.\n");
    }
}