ITypeLib

タイプライブラリ、すなわち一連のオブジェクトを記述するデータを表します。(ITypeLib)

システムレジストリには、インストールされているすべてのタイプライブラリの一覧が格納されています。タイプライブラリの構成を次の図に示します。

:::image type="content" source="./images/oa03_10.Png" border="false" alt-text="インストールされたタイプライブラリがシステムレジストリに列挙される際の構成を示す図。":::

ITypeLib インターフェイスは、型情報のライブラリにアクセスするためのメソッドを提供します。このインターフェイスは以下をサポートします。

• 型情報に対する汎用的なコンテインメント。ITypeLib は、ライブラリに含まれる型情報の反復処理を可能にします。
• グローバル関数とデータ。タイプライブラリは、データや関数をエクスポートする一連のモジュール(.DLL)の記述を含むことができます。タイプライブラリは、エクスポートされたデータや関数への参照のコンパイルをサポートします。
• 全般情報。ライブラリのユーザーが読み取り可能な名前や、ライブラリ全体のヘルプなどが含まれます。

タイプライブラリ内に存在する型情報の数を返します。

タイプライブラリ内の型情報の数。

ライブラリ内の指定された型情報を取得します。

このメソッドは、次のいずれかの値を返します。

デュアルインターフェイスの場合、GetTypeInfo は TKIND_DISPATCH の型情報のみを返します。TKIND_INTERFACE の型情報を取得するには、TKIND_DISPATCH の型情報に対してインデックス -1 を指定して GetRefTypeOfImplType を呼び出します。その後、返された型情報のハンドルを GetRefTypeInfo に渡します。

例

次の例は、デュアルインターフェイスの TKIND_INTERFACE 型情報を取得します。

HRESULT hr;
hr = ptlib->GetTypeInfo((unsigned int) dwIndex, &ptypeinfoDisp);
if (FAILED(hr)) {
   //free resources
   return hr;
}
hr = ptypeinfoDisp->GetRefTypeOfImplType(-1, &phreftype);
if (FAILED(hr)) {
   //free resources
   return hr;

hr = ptypeinfoDisp->GetRefTypeInfo(phreftype, &ptypeinfoInt);
if (FAILED(hr)) {
   //free resources
   return hr;

// 

型情報の種類を取得します。

このメソッドは、次のいずれかの値を返します。

指定された GUID に対応する型情報を取得します。

このメソッドは、次のいずれかの値を返します。

ライブラリの属性を格納する構造体を取得します。

このメソッドは、次のいずれかの値を返します。

TLIBATTR 構造体が占有するメモリを解放するには、ITypeLib::ReleaseTLibAttr を使用します。

クライアントコンパイラが、ライブラリの型、変数、定数、およびグローバル関数にバインドできるようにします。

このメソッドは、次のいずれかの値を返します。

返された TypeComp の Bind 関数は、グローバル関数、変数、定数、列挙値、および coclass メンバーにバインドします。Bind 関数は、TKIND_MODULE、TKIND_ENUM、TKIND_COCLASS の TYPEKIND 列挙の名前にもバインドします。これらの名前は、型情報内で定義された任意のグローバル名を隠蔽します。Application オブジェクトとしてマークされた TKIND_ENUM、TKIND_MODULE、TKIND_COCLASS 型のメンバーは、モジュール名を指定せずに ITypeComp から直接バインドできます。

ITypeComp::Bind および ITypeComp::BindType は、修飾されていない名前のみを受け付けます。ITypeLib::GetTypeComp は ITypeComp インターフェイスへのポインターを返し、これを使用してライブラリ内のグローバル要素にバインドします。一部の型(TKIND_ENUM、TKIND_MODULE、TKIND_COCLASS)の名前は、変数、関数、定数、および列挙子と名前空間を共有します。

メンバーを名前空間内の他の項目と区別するために修飾が必要な場合、目的のメンバーにバインドするために各修飾子ごとに GetTypeComp を順次呼び出すことができます。これにより、プログラミング言語のコンパイラは、修飾名でバインドできないメンバーであっても、モジュール、列挙型、および coclass のメンバーにアクセスできます。

ライブラリのドキュメント文字列、完全なヘルプファイル名とパス、およびヘルプファイル内のライブラリのヘルプトピックのコンテキスト識別子を取得します。

このメソッドは、次のいずれかの値を返します。

呼び出し側は、パラメーター pBstrName、pBstrDocString、および pBstrHelpFile を解放する必要があります。

渡された文字列が、ライブラリに記述された型またはメンバーの名前を含むかどうかを示します。

このメソッドは、次のいずれかの値を返します。

タイプライブラリ内で型情報の出現箇所を検索します。これは、タイプライブラリ内に名前が存在することを素早く確認するために使用できます。

このメソッドは、次のいずれかの値を返します。

*pcFound = n を渡すことは、ppTInfo および rgMemId 配列に n 個の (ptinfo, memid) ペアを格納するのに十分な領域があることを示します。szNameBuf 内の名前が ppTInfo[i] の型情報の名前である場合、この関数は rgMemId[i] に MEMBERID_NIL を返します。

GetLibAttr から元々取得した TLIBATTR を解放します。