Important: The information in this document is obsolete and should not be used for new development.
Catalog Move Parameter Blocks
The low-level HFS functionPBCatMove
uses the catalog move parameter block defined by theCMovePBRec
data type.
TYPE CMovePBRec = {catalog move parameter block} RECORD qLink: QElemPtr; {next queue entry} qType: Integer; {queue type} ioTrap: Integer; {routine trap} ioCmdAddr: Ptr; {routine address} ioCompletion: ProcPtr; {pointer to completion routine} ioResult: OSErr; {result code} ioNamePtr: StringPtr; {pointer to pathname} ioVRefNum: Integer; {volume specification} filler1: LongInt; {reserved} ioNewName: StringPtr; {name of new directory} filler2: LongInt; {reserved} ioNewDirID: LongInt; {directory ID of new directory} filler3: ARRAY[1..2] OF LongInt; {reserved} ioDirID: LongInt; {directory ID of current directory} END;
Field Description
qLink
- 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.)
qType
- The queue type. (This field is used internally by the File Manager.)
ioTrap
- The trap number of the routine that was called. (This field is used internally by the File Manager.)
ioCmdAddr
- The address of the routine that was called. (This field is used internally by the File Manager.)
ioCompletion
- A pointer to a completion routine to be executed at the end of an asynchronous call. It should be
NIL
for asynchronous calls with no completion routine and is automatically set toNIL
for all synchronous calls. See "Completion Routines" on page 2-238 for information about completion routines.ioResult
- 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; it's set to a positive number when the call is made and receives the actual result code when the call is completed.
ioNamePtr
- A pointer to a pathname. Whenever a routine description specifies that
ioNamePtr
is used--whether for input, output, or both--it's very important that you set this field to point to storage for aStr255
value (if you're using a pathname) or toNIL
(if you're not).ioVRefNum
- A volume specification (volume reference number, working directory reference number, drive number, or 0 for default volume).
filler1
- Reserved.
ioNewName
- The name of the directory into which the specified file or directory is to be moved.
filler2
- Reserved.
ioNewDirID
- The directory ID of the directory into which the specified file or directory is to be moved.
filler3
- Reserved.
ioDirID
- The current directory ID of the file or directory to be moved (used in conjunction with the
ioVRefNum
andioNamePtr
fields).
© Apple Computer, Inc.
2 JUL 1996