_GET_REFERENCE_ID_

_GET_REFERENCE_ID_

Returns a reference identifier for use with any automation object method that requires an automation object as one of its parameters

Syntax
Details
Example

Syntax

CALL NOTIFY(OLE-object-name,'_GET_REFERENCE_ID_',out-refid);

CALL SEND(OLE-object-id,'_GET_REFERENCE_ID_',out-refid);

Where... Is type... And...

out-refid
C contains the returned reference identifier.

Where...	Is type...	And...
out-refid	C	contains the returned reference identifier.

Details

The _GET_REFERENCE_ID_ method is used to get the automation object identifier. The value returned is used in subsequent _DO_ or _COMPUTE_ calls where the object method requires an automation object as one of its parameters. This value should be used for the object parameter.

Example

The following example returns the reference identifier for the automation object. This identifier is then sent as a parameter value to an automation method requiring an object identifier.

call notify('oleobj1', '_GET_REFERENCE_ID_', 
            refid);
call notify('oleobj2', '_DO_', 'NewAppl', 
            refid, p1, p2);

Chapter Contents
Previous
Next
Top of Page