Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Files /
Chapter 2 - File Manager / File Manager Reference
High-Level File Access Routines / Allocating File Blocks


AllocContig

You can use the AllocContig function to allocate additional contiguous blocks to an open file.

FUNCTION AllocContig (refNum: Integer; VAR count: LongInt): OSErr;
refNum
The file reference number of an open file.
count
On input, the number of additional bytes to allocate to the file; on output, the number of bytes allocated, rounded up to the nearest multiple of the allocation block size.
DESCRIPTION
The AllocContig function is identical to the Allocate function except that if there isn't enough contiguous empty space on the volume to satisfy the allocation request, AllocContig does nothing and returns dskFulErr as its function result. If you want to allocate whatever space is available, even when the entire request cannot be filled by the allocation of a contiguous piece, call Allocate instead.

RESULT CODES
noErr 0No error
dskFulErr-34Disk full
ioErr-36I/O error
fnOpnErr-38File not open
wPrErr-44Hardware volume lock
fLckdErr-45File is locked
vLckdErr-46Software volume lock
rfNumErr-51Bad reference number
wrPermErr-61Read/write permission doesn't allow writing

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996