Legacy Document

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

Inside Macintosh: Speech Recognition Manager /

Chapter 1 - Speech Recognition Manager / Speech Recognition Manager Reference

Speech Recognition Manager Routines / Managing Speech Objects

SRGetReference
You can use the SRGetReference function to obtain an extra reference to a speech object.
pascal OSErr SRGetReference (
SRSpeechObject srObject, 
SRSpeechObject *newObjectRef);
srObject
A speech object.
newObjectRef
On exit, a new reference to the specified speech object.

DESCRIPTION
The SRGetReference function returns, in the newObjectRef parameter, a new reference to the speech object specified by the srObject parameter. 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.

SPECIAL CONSIDERATIONS
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're done using it.