Carbon


SRGetReference

Header: SpeechRecognition.h Carbon status: Supported

Obtains an extra reference to a speech object.

OSErr SRGetReference (
    SRSpeechObject srObject, 
    SRSpeechObject *newObjectRef
);
Parameter descriptions
srObject

A speech object.

newObjectRef

On return, a new reference to the specified speech object.

function result

A result code.

DISCUSSION

The original object reference (contained in srObject) and the new reference (returned in newObjectRef) may have different values. Accordingly, you cannot simply compare two object references to determine whether they are references to the same speech object.

SRGetReference increases the reference count of the specified speech object. You should call the SRReleaseObject function to release the object reference returned by SRGetReference when you are done using it.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


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