getRefTypeInfo         package:SWinTypeLibs         R Documentation

_F_i_n_d _t_h_e _I_T_y_p_e_I_n_f_o _o_b_j_e_c_t _f_o_r _t_h_e _t_y_p_e _g_i_v_e_n _i_n _a _T_y_p_e_D_e_s_c_r_i_p_t_i_o_n_R_e_f _o_b_j_e_c_t.

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

     This function resolves the  'ITypeInfo-class' element in a type
     library for a given 'TypeDescriptionRef-class' object. These
     'TypeDescriptionRef-class'  objects arise in the description of
     parameter types and return types of DCOM methods  via 'getFuncs'
     and we  need to resolve them to find their actual definitions  in
     terms of DCOM interfaces. This function performs that action of
     mapping the information in the 'TypeDescriptionRef-class'  object 
     to a 'ITypeInfo-class'.

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

     getRefTypeInfo(info, href, lib = NULL, follow = !is.null(lib))

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

    info: the 'ITypeInfo-class' object in which to resolve the
          reference.

    href: the identifier for the reference, typically the 'reftype'
          slot of a 'TypeDescriptionRef-class' object

  follow: a logical value indicating whether to resolve the referenced
          type across type libraries. This arises when  library A
          refers to this type as a parameter or return value but it is
          actually defined in a type library, B say.  We can resolve
          this in library A, but the results may be generic (e.g.  an
          enumeration may have a name Constants rather than the more
          specific name).  If we resolve the type in library B, then we
          can get the more  specific 'ITypeInfo-class' object.

     lib: an object of class 'ITypeLib-class'. This is connected to the
          'follow' argument the purpose of which you should understand
          before reading this.  This argument provides the library
          instance in which we encountered the reference (given by
          'href'). If it is provided and 'follow' is 'TRUE', then we
          will  use this 'lib' value to determine if we the 'ITypeInfo'
          object is defined in a different library or this one. If it
          is defined in a different library and 'follow' is 'TRUE', 
          then we will resolve it there. So, this 'lib' parameter
          allows us to  compare the origin of the definition of the
          type and resolve it appropriately. 

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

     An object of some class derived  from 'ITypeInfo-class' depending
     on the type the reference identifies.

_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://msdn.microsoft.com/library> <URL:
     http://www.omegahat.org/RWinTypeLibs>

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

     'getTypeInfo', specifically the method for 'ITypeInfo,
     TypeDescriptionRef'. 'getRefTypeName'

_E_x_a_m_p_l_e_s:

     ## Not run: 

     ## End(Not run)

