![]() |
HFileInfo |
Header: Files.h |
struct HFileInfo { QElemPtr qLink; SInt16 qType; SInt16 ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; SInt16 ioVRefNum; SInt16 ioFRefNum; SInt8 ioFVersNum; SInt8 filler1; SInt16 ioFDirIndex; SInt8 ioFlAttrib; SInt8 ioACUser; FInfo ioFlFndrInfo; SInt32 ioDirID; UInt16 ioFlStBlk; SInt32 ioFlLgLen; SInt32 ioFlPyLen; UInt16 ioFlRStBlk; SInt32 ioFlRLgLen; SInt32 ioFlRPyLen; UInt32 ioFlCrDat; UInt32 ioFlMdDat; UInt32 ioFlBkDat; FXInfo ioFlXFndrInfo; SInt32 ioFlParID; SInt32 ioFlClpSiz; };
A pointer to the next entry in the file I/O queue. (This field is used internally by the File Manager to keep track of asynchronous calls awaiting execution.)
The queue type. (This field is used internally by the File Manager.)
The trap number of the function that was called. (This field is used internally by the File Manager.)
The address of the function that was called. (This field is used internally by the File Manager.)
A pointer to a completion routine to be executed at the end of an asynchronous call. It should be NULL for asynchronous calls with no completion routine and is automatically set to NULL for all synchronous calls. See IOCompletionProcPtr for information about completion routines.
The result code of the function. For synchronous calls, this field is the same as the result code of the function call itself. To determine when an asynchronous call has actually been completed, your application can poll this field; its set to a positive number when the call is made and receives the actual result code when the call is completed.
A pointer to a pathname. Whenever a function description specifies that ioNamePtr is usedwhether for input, output, or bothits very important that you set this field to point to storage for a Str255 value (if youre using a pathname) or to NULL (if youre not).
A volume specification. You can specify a volume using a volume reference number, a drive number, a working directory reference number, or 0 for the default drive.
The file reference number of an open file.
A file version number. This field is no longer used and you should always set it to 0.
Reserved.
A file and directory index. If this field contains a positive number, PBGetCatInfo returns information about the file or directory having that directory index in the directory specified by the ioVRefNum field. (If ioVRefNum contains a volume reference number, the specified directory is that volumes root directory.)
If this field contains 0, PBGetCatInfo returns information about the file or directory whose name is specified in the ioNamePtr field and that is located in the directory specified by the ioVRefNum field. (Once again, if ioVRefNum contains a volume reference number, the specified directory is that volumes root directory.)
If this field contains a negative number, PBGetCatInfo ignores the ioNamePtr field and returns information about the directory specified in the ioDirID field. If both ioDirID and ioVRefNum are set to 0, PBGetCatInfo returns information about the current default directory.
File or directory attributes. The bits in this field have the following meanings:
Set if file is locked
Reserved
Set if resource fork is open
Set if data fork is open
Set if a directory
Reserved
Set if file (either fork) is open
The users access rights for the specified directory. The bits in this field have the following meanings:
Set if user does not have See Folder privileges
Set if user does not have See Files privileges
Set if user does not have Make Changes privileges
Reserved; always set to 0
Set if user is not owner of the directory
For example, if you call PBGetCatInfo for a particular shared volume and ioACUser returns 0, you know that the user is the owner of the directory and has complete privileges to it.
Information used by the Finder.
A directory ID or file ID. On input to PBGetCatInfo, this field contains a directory ID (which is used only if the ioFDirIndex field is negative). On output, this field contains the file ID of the specified file.
The first allocation block of the data fork. This field contains 0 if the files data fork is empty.
The logical end-of-file of the data fork.
The physical end-of-file of the data fork.
The first allocation block of the resource fork.
The logical end-of-file of the resource fork.
The physical end-of-file of the resource fork.
The date and time of the files creation, specified in seconds since midnight, January 1, 1904.
The date and time of the last modification to the file, specified in seconds since midnight, January 1, 1904.
The date and time of the last backup to the file, specified in seconds since midnight, January 1, 1904.
Additional information used by the Finder.
The directory ID of the files parent.
The clump size to be used when writing the file; if its 0, the volumes clump size is used when the file is opened.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)