Carbon


CMovePBRec

Header: Files.h

struct CMovePBRec {
    QElemPtr qLink; 
    SInt16 qType; 
    SInt16 ioTrap; 
    Ptr ioCmdAddr; 
    IOCompletionUPP ioCompletion; 
    volatile OSErr ioResult; 
    StringPtr ioNamePtr; 
    SInt16 ioVRefNum; 
    SInt32 filler1; 
    StringPtr ioNewName; 
    SInt32 filler2; 
    SInt32 ioNewDirID; 
    SInt32 filler3[2]; 
    SInt32 ioDirID; 
    QElem *qLink; 
    SInt16 qType; 
    SInt16 ioTrap; 
    Ptr ioCmdAddr; 
    ATPCompletionUPP ioCompletion; 
    OSErr ioResult; 
    SInt32 userData; 
    SInt16 reqTID; 
    SInt16 ioRefNum; 
    UInt8 ataTFFeatures; 
    UInt8 ataTFCount; 
    UInt8 ataTFSector; 
    UInt8 ataTFReserved; 
    UInt16 ataTFCylinder; 
    UInt8 ataTFSDH; 
    UInt8 ataTFCommand; 
    Fixed frequency; 
    Fixed angle; 
    UInt32 spotFunction;
};
typedef CMovePBRec CMovePBPtr;

Field descriptions

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 function that was called. (This field is used internally by the File Manager.)

ioCmdAddr

The address of the function 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 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.

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 function 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 a Str255 value (if you’re using a pathname) or to NULL (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 and ioNamePtr fields).

The low-level HFS function PBCatMove uses the catalog move parameter block defined by the CMovePBRec data type.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)