Guardian Programming Reference Summary for C

Functions Summary (O-Q)
Guardian Programming Reference Summary for C—522630-001
7-3
returned value:
OPEN
(superseded by FILE_OPEN_) Establishes a communication path between an
application process and a file. OPEN returns a file number to the application process.
This procedure operates only on Guardian objects.
This procedure does not have a C syntax, because it is superseded and should not be
used for new development. This procedure is supported only for compatibility with
previous software.
OPEN^FILE
Allows access to a file.
flags
0 = Message successfully converted.
1 = File-system error; error-detail contains the file-system error number.
2 = Parameter error; error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
3 = Bounds error; error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
4 = The supplied system message is not supported by this procedure; no
conversion was performed.
#include <cextdecs(OPEN_FILE)>
short OPEN_FILE ( short _near *common-fcb /* i */
,short _near *file-fcb /* i */
,[ short _near *block-buffer ] /* i */
,[ short block-bufferlen ] /* i */
,[ long flags ] /* i */
,[ long flags-mask ] /* i */
,[ short max-recordlen ] /* i */
,[ short prompt-char ] /* i */
,[ short _near *error-file-fcb ] );/* i */
Note. Combine selected values using signed addition, because bit 0 is not used.
ABORT^OPENERR %1D
ABORT^XFERERR %2D
AUTO^CREATE %10D
AUTO^TOF %100D