NAME
    Examine -- Examine a directory or file associated with a lock

SYNOPSIS
    success = Examine( lock, fileinfoblock )
    D0                  D1        D2

    BOOL Examine(BPTR,struct fileinfoblock *)

FUNCTION
    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().

INPUTS
    lock      - BCPL pointer to a lock
    infoBlock - pointer to a fileinfoblock (must be longword aligned)

RESULTS
    success - boolean

SPECIAL NOTE
    fileinfoblock must be longword-aligned.  allocdosobject() will
    allocate them correctly for you.

SEE ALSO
    lock(), unlock(), exnext(), examinefh(), <dos/dos.h>, allocdosobject(),
    exall()