Oma_Ot_Writer_Open_With_Options()
Abstract
Creates or reopens an OT file for writing, based on supplied options.
Syntax
Oma_Ot_Writer_Open_With_Options (ot_file_name_or_path, open_options)
| Argument | Type | Description |
|---|---|---|
ot_file_name_or_path |
const char * |
Base name (no path or extension) or full path of the OT file to open. If a base name, the directory containing the file must be included in the mod_dirs preference. |
open_options |
int |
Mode for opening the OT writer (see Details). |
Return Type
OmaT_Ot_Writer *
The newly opened OT writer. PRGC_NIL if ot_file_name_or_path is invalid, the file cannot be opened, or a writer cannot be allocated.
Header
oma_ot.h
Details
open_options must be some OR’d combination of the following constants:
OMAC_OT_WRITER_OPEN_OPT_CREATEOMAC_OT_WRITER_OPEN_OPT_APPENDOMAC_OT_WRITER_OPEN_OPT_FORCE_WRITE_ONCEOMAC_OT_WRITER_OPEN_OPT_FORCE_WRITE_MANY
The returned OT file writer should be closed and destroyed with Oma_Ot_Writer_Close() to free its data.