ITypeLib2 Interface

IID_ITypeLib2

{00020411-0000-0000-C000-000000000046}

The ITypeLib2 interface inherits from the ITypeLib interface. This allows ITypeLib to cast to an ITypeLib2 in performance-sensitive cases, rather than perform extra QueryInterface() and Release() calls.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ITypeLib Methods

Description

GetTypeInfoCount

Returns the number of type descriptions in the type library.

GetTypeInfo

Retrieves the specified type description in the library.

GetTypeInfoType

Retrieves the type of a type description.

GetTypeInfoOfGuid

Retrieves the type description that corresponds to the specified GUID.

GetLibAttr

Retrieves the structure that contains the library's attributes.

GetTypeComp

Enables a client compiler to bind to a library's types, variables, constants, and global functions.

GetDocumentation

Retrieves the library's documentation string, the complete Help file name and path, and the context identifier for the library Help topic in the Help file.

IsName

Indicates whether a passed-in string contains the name of a type or member described in the library.

FindName

Finds occurrences of a type description in a type library. This may be used to quickly verify that a name exists in a type library.

ReleaseTLibAttr

Releases the TLIBATTR originally obtained from ITypeLib::GetLibAttr.

ITypeLib2 Methods

Description

GetCustData

Gets the custom data.

GetLibStatistics

Returns statistics about a type library that are required for efficient sizing of hash tables.

GetDocumentation2

Retrieves the library's documentation string, the complete Help file name and path, the localization context to use, and the context ID for the library Help topic in the Help file.

GetAllCustData

Gets all custom data items for the library.

CUSTDATAITEM structure

TYPE CUSTDATAITEM
   rguid AS GUID
   varValue AS VARIANTAPI
END TYPE

CUSTDATA structure

TYPE CUSTDATA
   cCustData AS DWORD
   prgCustData AS CUSTDATAITEM PTR
END TYPE

GetCustData

FUNCTION ITypeLib2_GetCustData ( _

  BYVAL pthis AS DWORD PTR _

, BYREF riid AS GUID _

, BYREF pVarVal AS VARIANT _

  ) AS DWORD

  LOCAL HRESULT AS DWORD
  CALL DWORD @@pthis[13] USING ITypeLib2_GetCustData (pthis, riid, pVarVal) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetLibStatistics

FUNCTION ITypeLib2_GetLibStatistics ( _

  BYVAL pthis AS DWORD PTR _

, BYREF pcUniqueNames AS DWORD _

, BYREF pcchUniqueNames AS DWORD _

  ) AS DWORD

  LOCAL HRESULT AS DWORD
  CALL DWORD @@pthis[14] USING ITypeLib2_GetLibStatistics (pthis, pcUniqueNames, pcchUniqueNames) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetDocumentation2

FUNCTION ITypeLib2_GetDocumentation2 ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL index AS LONG _

, BYVAL lcid AS LONG _

, BYREF strHelpString AS STRING _

, BYREF pdwHelpStringContext AS DWORD _

, BYREF strHelpStringDll AS STRING _

  ) AS DWORD

  LOCAL HRESULT AS DWORD
  CALL DWORD @@pthis[15] USING ITypeLib2_GetDocumentation2 (pthis, index, lcid, strHelpString, pdwHelpStringContext, strHelpStringDll) TO HRESULT

  strHelpString = ACODE$(strHelpString)

  strHelpStringDll = ACODE$(strHelpStringDll)
  FUNCTION = HRESULT

END FUNCTION

GetAllCustData

FUNCTION ITypeLib2_GetAllCustData ( _

  BYVAL pthis AS DWORD PTR _

, BYREF pCustData AS CUSTDATA _

  ) AS DWORD

  LOCAL HRESULT AS DWORD
  CALL DWORD @@pthis[16] USING ITypeLib2_GetAllCustData (pthis, pCustData) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION