Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 17 - File Objects / File Objects Reference

File Objects Routines / Attaching File Objects to Storage Objects

Q3File_SetStorage

You can use the Q3File_SetStorage function to set the storage object for a file object.

TQ3Status Q3File_SetStorage (
TQ3FileObject file, 
TQ3StorageObject storage);

file

A file object.

storage

A storage object, or NULL.

DESCRIPTION

The Q3File_SetStorage function attaches the file object specified by the file parameter to the storage object specified by the storage parameter. The reference count of the storage object is incremented. You can pass the value NULL in the storage parameter to clear a file object's storage.

You cannot attach the same storage object to more than one file object.

ERRORS

kQ3ErrorFileAlreadyOpen
kQ3ErrorInvalidObject
kQ3ErrorStorageInUse