[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        NameFromLock -- Returns the name of a locked object (V36)

   SYNOPSIS
        success = NameFromLock(lock, buffer, len)
        D0                      D1     D2    D3

        bool namefromlock(bptr, strptr, long)

   FUNCTION
        Returns a fully qualified path for the lock.  This routine is
        guaranteed not to write more than len characters into the buffer.  The
        name will be null-terminated.  NOTE: if the volume is not mounted,
        the system will request it (unless of course you set pr_WindowPtr to
        -1).  If the volume is not mounted or inserted, it will return an
        error.  If the lock passed in is NULL, "SYS:" will be returned. If
        the buffer is too short, an error will be returned, and ioerr() will
        return ERROR_LINE_TOO_LONG.

   INPUTS
        lock   - lock of object to be examined.
        buffer - Buffer to store name.
        len    - Length of buffer.

   RESULT
        success - Success/failure indicator.

   BUGS
        Should return the name of the boot volume instead of SYS: for a NULL
        lock.

   SEE ALSO
        namefromfh(), lock()