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

Details

OLE Arguments
Argument	Character (C) or Numeric (N)	Description
out-refid	C	contains the returned reference identifier.

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