ITypeComp::BindType

HRESULT BindType( 
  OLECHAR FAR*  szName,         
  unsigned long  lHashVal,      
  ITypeInfo FAR* FAR*  ppTInfo,  
  ITypeComp FAR* FAR*  ppTComp  
);

Binds to the type descriptions contained within a type library.

Parameters

szName: Name to be bound.
lHashVal: Hash value for the name computed by LHashValOfName.
ppTInfo: On return, contains a pointer to a pointer to an ITypeInfo of the type to which the name was bound.
ppTComp: Passes a valid pointer, such as the address of an ITypeComp* variable.

Return Value

The return value obtained from the returned HRESULT is one of the following:

Return value	Meaning
S_OK	Success.
E_OUTOFMEMORY	Out of memory.
E_INVALIDARG	One or more of the arguments is invalid.
TYPE_E_IOERROR	The function could not read from the file.
TYPE_E_INVDATAREAD	Invalid data.
TYPE_E_UNSUPFORMAT	The type library has an older format.
TYPE_E_INVALIDSTATE	The type library could not be opened.
TYPE_E_AMBIGUOUSNAME	More than one instance of this name occurs in the type library.

Comments

Use the function BindType for binding a type name to the ITypeInfo that describes the type. This function is invoked on the ITypeComp that is returned by ITypeLib::GetTypeComp to bind to types defined within that library. It can also be used in the future for binding to nested types.

Example

    TypeComp * ptcomp;
        ptemp -> BindType(szName, lhashval, &ptinfo, &ptemp)