SCL Methods for Automating OLE Objects under Windows

_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);

Argument	Character (C) or Numeric (N)	Description
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);

Top of Page