createCOMReference        package:RDCOMClient        R Documentation

_C_r_e_a_t_e_s _S _o_b_j_e_c_t _f_o_r _C_O_M _r_e_f_e_r_e_n_c_e

_D_e_s_c_r_i_p_t_i_o_n:

     This is the function that is called anytime a COM object is being
     created or returned from a C language call to S. This function can
     examine the object and determine what is the best representation
     in S for it. It can use the generic 'IUnknown' or 'COMIDispatch'
     classes to simply represent the pointer value. Alternatively, it
     might dynamically generate a new S class and accessor methods for
     accessing properties and functions for that object using the
     'SWinTypeLibs' package. Or it might lookup a previously compiled
     collection of type information and match the GUID of the object's
     type  to find the associated S class name.

     This function is not intended to be called from S, but primarily
     from C code that has access to the COM references.

_U_s_a_g_e:

     createCOMReference(ref, className)

_A_r_g_u_m_e_n_t_s:

     ref: the S object that is an external pointer containing the
          reference to the COM object. 

className: The name of the class that is ``suggested'' by the caller.

_V_a_l_u_e:

     An S object that should almost definitely contain the 'ref' value.
     The class of the object should probably extend 'IUnknown'.

_A_u_t_h_o_r(_s):

     Duncan Temple Lang (duncan@wald.ucdavis.edu)

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.omegahat.org/RDCOMClient> <URL:
     http://www.omegahat.org/RDCOMServer> <URL:
     http://www.omegahat.org/SWinTypeLibs>

_S_e_e _A_l_s_o:

     'COMCreate' '.COM'

