Docs » Autodocs » dos.library » Examine
Examine -- Examine a directory or file associated with a lock
success = Examine( lock, FileInfoBlock )
D0 D1 D2
BOOL Examine(BPTR,struct FileInfoBlock *)
Examine() fills in information in the FileInfoBlock concerning the
file or directory associated with the lock. This information
includes the name, size, creation date and whether it is a file or
directory. FileInfoBlock must be longword aligned. Examine() gives
a return code of zero if it fails.
You may make a local copy of the FileInfoBlock, as long as it is
never passed to ExNext().
lock - BCPL pointer to a lock
infoBlock - pointer to a FileInfoBlock (MUST be longword aligned)
success - boolean
SPECIAL NOTE
FileInfoBlock must be longword-aligned. AllocDosObject() will
allocate them correctly for you.
Lock(), UnLock(), ExNext(), ExamineFH(), <dos/dos.h>, AllocDosObject(), ExAll()
|
