ITypeLib::GetTypeInfo

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the specified type description in the library.

Syntax

HRESULT GetTypeInfo( 
  unsigned int index, 
  ITypeInfo FAR* FAR* ppTInfo 
); 

Parameters

  • index
    [in] Index of the ITypeInfo interface to be returned.
  • ppTInfo
    [out] If successful, returns a pointer to the pointer to the ITypeInfo interface.

Return Value

The following table shows the return values for this function.

Value Description

S_OK

Success.

TYPE_E_ELEMENTNOTFOUND

The index parameter is outside the range of 0 to ITypeLib::GetTypeInfoCount –1.

E_OUTOFMEMORY

Out of memory.

E_INVALIDARG

One or more of the parameters 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_REGISTRYACCESS

There was an error accessing the system registration database.

TYPE_E_INVALIDSTATE

The type library could not be opened.

Remarks

For dual interfaces, ITypeLib::GetTypeInfo returns only the TKIND_DISPATCH type information.

To get the TKIND_INTERFACE type information, ITypeInfo::GetRefTypeOfImplType can be called on the TKIND_DISPATCH type information, passing an index of –1. Then, the returned type information handle can be passed to ITypeInfo::GetRefTypeInfo.

Example

The following code example gets the TKIND_INTERFACE type information for a dual interface.

ptlib->GetTypeInfo((unsigned int) dwIndex, &ptypeinfoDisp);
ptypeinfoDisp->GetRefTypeOfImplType(-1, &phreftype);
ptypeinfoDisp->GetRefTypeInfo(phreftype, &ptypeinfoInt);

Requirements

Header oaidl.h, oaidl.idl
Library oleaut32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ITypeLib
ITypeInfo::GetRefTypeInfo
ITypeInfo::GetRefTypeOfImplType
ITypeLib::GetTypeInfoCount