Carbon


FNSProfileAddReference

Header: FontSync.h Carbon status: Supported

Adds a font reference to a profile.

OSStatus FNSProfileAddReference (
    FNSFontProfile iProfile, 
    FNSFontReference iReference
);
Parameter descriptions
iProfile

A reference to the font profile to which you want to add a font reference. The profile must be writable.

iReference

A reference to the font reference you wish to add.

function result

A result code. The result code kFNSBadProfileVersionErr indicates that a font profile has an unsupported format version. This may indicate that the profile is valid, but created by a later version of FontSync, or that the profile is truly invalid. The result code kFNSInvalidProfileErr indicates that a profile does not have a valid structure. The result code kFNSBadReferenceVersionErr indicates that a font reference has an unsupported format version. This may indicate that the reference is valid, but created by a later version of FontSync, or that the reference is truly invalid. The result code kFNSInvalidReferenceErr indicates that a font reference is invalid. The result code kFNSDuplicateReferenceErr indicates that an identical reference already exists in the profile. In this case, the new one is not added. The File Manager error permErr indicates that the file is either locked and not editable or opened for read-only access. FNSProfileAddReference may return other File Manager errors. Memory Manager errors indicate that you did not have enough memory available in your heap.

DISCUSSION

The FNSProfileAddReference function adds a font reference to a profile that has read/write access. If an identical reference already exists in the profile, the reference is not added and the result code kFNSDuplicateReferenceErr is returned. A matching reference is not necessarily identical, since not all the data in a font reference is examined when a matching operation is performed.

VERSION NOTES

Available beginning with FontSync 1.0.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when Font Sync 1.0 or later is present.


© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)