Carbon


CatPositionRec

Header: Files.h

struct CatPositionRec {
    SInt32 initialize; 
    SInt16 priv[6];
};

Field descriptions

initialize

The starting point of the catalog search. To start searching at the beginning of a catalog, specify 0 in this field. To resume a previous search, pass the value returned by the previous call to PBCatSearch.

priv

An array of integers that is used internally by PBCatSearch.

When you call the PBCatSearch function to search a volume’s catalog file, you can specify (in the ioCatPosition field of the parameter block passed to PBCatSearch) a catalog position structure. If a catalog search consumes more time than is allowed by the ioSearchTime field, PBCatSearch stores a directory-location index in that structure; when you call PBCatSearch again, it uses that structure to resume searching where it left off. A catalog position structure is defined by the CatPositionRec data type.


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