Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 2 - Edition Manager / Edition Manager Reference

Edition Manager Routines / Edition Container Formats

GetStandardFormats

You probably do not need to call the GetStandardFormats function directly because the Edition Manager calls this function.

FUNCTION GetStandardFormats 
               (container: EditionContainerSpec; 
                VAR previewFormat: FormatType;
                preview, publisherAlias, formats: Handle): OSErr;

container

An edition container record that specifies the edition volume reference number, directory ID, filename, and part.

previewFormat

The GetStandardFormats function returns in this parameter a handle to the first format of the requested format type that it finds in the edition.

preview

A format type. The GetStandardFormats function looks for a format of the type specified in this parameter and returns in this parameter the format type of the first format that it finds. The function tries to find one of four formats: 'prvw', 'PICT', 'TEXT', or 'snd '.

publisherAlias

The publisherAlias parameter reads the format kPublisherDocAliasFormat ('alis').

formats

The formats parameter reads the virtual format kFormatListFormat ('fmts').

DESCRIPTION

You should pass in valid handles for the formats that you want and NIL for the formats that you don't want. The handles are resized to the size of the data.

If one of the requested formats cannot be found, GetStandardFormats returns a noTypeErr result code.

RESULT CODES

noErr	0	No error
noTypeErr	-102	Edition container not found
editionMgrInitErr	-450	Manager not initialized