Guardian Procedure Calls Reference Manual

FILE_GETOPENINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The FILE_GETOPENINFO_ procedure obtains information about the opens of one disk file or all
the files on a disk device, or the opens of certain nondisk devices. Each call returns information
about one open; make successive calls to FILE_GETOPENINFO_ to learn about all the opens.
Syntax for C Programmers
#include <cextdecs(FILE_GETOPENINFO_)>
short FILE_GETOPENINFO_ ( const char *searchname
,short length
,long long *prevtag
,[ short *primary-opener ]
,[ short *backup-opener ]
,[ short *accessmode ]
,[ short *exclusion ]
,[ short *syncdepth ]
,[ char *filename ]
,[ short maxlen ]
,[ short *filenamelen ]
,[ short *accessid ]
,[ short *validmask ] );
• The parameter maxlen specifies the maximum length in bytes of the character string pointed
to by filename, the actual length of which is returned by filenamelen. All three of these
parameters must either be supplied or be absent.
Syntax for TAL Programmers
error := FILE_GETOPENINFO_ ( searchname:length ! i:i
,prevtag ! i,o
,[ primary-opener ] ! o
,[ backup-opener ] ! o
,[ accessmode ] ! o
,[ exclusion ] ! o
,[ syncdepth ] ! o
,[ filename:maxlen ] ! o:i
,[ filenamelen ] ! o
,[ accessid ] ! o
,[ validmask ] ); ! o
FILE_GETOPENINFO_ Procedure 439