ITypeInfo

オブジェクトに関する情報を読み取るために使用します。(ITypeInfo)

型情報インターフェイスは、アプリケーションの内部で使用される部分ではなく、外部のクライアントから呼び出せる部分を記述することを目的としています。

ITypeInfo インターフェイスは、次の情報へのアクセスを提供します。

• 型に関連付けられた関数記述の集合。インターフェイスの場合、これはインターフェイス内のメンバー関数の集合を含みます。
• 型に関連付けられたデータメンバー記述の集合。構造体の場合、これは型のフィールドの集合を含みます。
• 構造体を記述するかインターフェイスを記述するかなど、型の一般的な属性。

ITypeInfo のインスタンスは、オブジェクトの型に関するさまざまな情報を提供し、複数の用途で使用されます。コンパイラーは ITypeInfo を使用して、型のメンバーへの参照をコンパイルできます。型インターフェイスブラウザーは、これを使用して型の各メンバーに関する情報を検索できます。IDispatch の実装者は、これを使用して IDispatch の呼び出しをインターフェイスへ自動的に委譲する仕組みを提供できます。

型記述の属性を格納する TYPEATTR 構造体を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

TYPEATTR 構造体を解放するには、ITypeInfo::ReleaseTypeAttr を使用します。

型記述の ITypeComp インターフェイスを取得します。これにより、クライアントコンパイラーは型記述のメンバーにバインドできます。

このメソッドは、次のいずれかの値を返すことがあります。

クライアントコンパイラーは、ITypeComp インターフェイスを使用して、型のメンバーにバインドできます。

指定された関数に関する情報を格納する FUNCDESC 構造体を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

ITypeInfo::GetFuncDesc 関数は、指定された index の関数を記述する FUNCDESC 構造体へのアクセスを提供します。FUNCDESC 構造体は ITypeInfo::ReleaseFuncDesc で解放する必要があります。型内の関数の数は、TYPEATTR 構造体に含まれる属性の 1 つです。

例

次の例では、CHECKRESULT 関数は未定義です。この関数を、独自のエラー処理コードに置き換えてください。

CHECKRESULT(ptypeinfo->GetFuncDesc(i, &pfuncdesc));
idMember = pfuncdesc->memid;
CHECKRESULT(ptypeinfo->GetDocumentation(idMember, &bstrName, NULL, NULL, NULL));
ptypeinfo->ReleaseFuncDesc(pfuncdesc);

指定された変数を記述する VARDESC 構造体を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

VARDESC 構造体を解放するには、ReleaseVarDesc を使用します。

例

次の例では、CHECKRESULT 関数は未定義です。この関数を、独自のエラー処理コードに置き換えてください。

CHECKRESULT(ptypeinfo->GetVarDesc(i, &pvardesc));
idMember = pvardesc->memid;
CHECKRESULT(ptypeinfo->GetDocumentation(idMember, &bstrName, NULL, NULL, 
      NULL));
ptypeinfo->ReleaseVarDesc(pvardesc);

指定されたメンバー ID を持つ変数、または指定された関数 ID に対応するプロパティやメソッドの名前とパラメーターを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

呼び出し元は、返された BSTR 配列を解放する必要があります。

メンバー ID がプロパティ関数で実装されたプロパティを識別する場合、プロパティ名が返されます。プロパティの get 関数の場合、関数名とそのパラメーターの名前が常に返されます。

プロパティの put 関数および put reference 関数の場合、代入の右辺には名前がありません。cMaxNames が関数のパラメーターのすべての名前を返すために必要な数より少ない場合、最初の cMaxNames - 1 個のパラメーターの名前のみが返されます。パラメーターの名前は、インターフェイス内の他の場所で現れるのと同じ順序 (たとえば、FUNCDESC 列挙に関連付けられたパラメーター配列と同じ順序) で配列に返されます。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために、必要に応じて基底の型記述に対して再帰的に処理を行います。

型記述が COM クラスを記述している場合、実装されているインターフェイス型の型記述を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

TKIND_DISPATCH 型記述がデュアルインターフェイスのものである場合、GetRefTypeOfImplType を index に –1 を指定して呼び出し、返された pRefTypehandle を GetRefTypeInfo に渡して型情報を取得することで、TKIND_INTERFACE 型記述を取得できます。

型記述内の、実装されている 1 つのインターフェイスまたは基底インターフェイスに対する IMPLTYPEFLAGS 列挙を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

これらのフラグは、継承という行為に関連付けられており、継承されるインターフェイスそのものに関連付けられているわけではありません。

メンバー名とメンバー ID の間、およびパラメーター名とパラメーター ID の間のマッピングを行います。

このメソッドは、次のいずれかの値を返すことがあります。

GetIDsOfNames 関数は、メンバーの名前 (rgszNames[0]) とそのパラメーター (rgszNames[1] ...rgszNames[cNames- 1]) を、メンバーの ID (pMemId[0]) および指定されたパラメーターの ID (pMemId[1] ... pMemId[cNames- 1]) にマッピングします。パラメーターの ID は、メンバー関数の引数リスト内の最初のパラメーターが 0、2 番目が 1、というように割り当てられます。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために、必要に応じて基底の型記述に対して再帰的に処理を行います。

型記述で記述されるインターフェイスを実装するオブジェクトのメソッドを呼び出すか、そのプロパティにアクセスします。

IDispatch::Invoke のいずれのエラーも返される可能性があります。

ITypeInfo::Invoke 関数を使用して、オブジェクトのメンバーにアクセスするか、この型記述で記述されるインターフェイスを実装するメソッドを呼び出します。IDispatch インターフェイスをサポートするオブジェクトの場合、Invoke を使用して IDispatch::Invoke を実装できます。

ITypeInfo::Invoke は、クラスのインスタンスへのポインターを受け取ります。それ以外の点では、そのパラメーターは IDispatch::Invoke と同じですが、ITypeInfo::Invoke では refiid パラメーターと lcid パラメーターが省略されます。呼び出されると、ITypeInfo::Invoke は、指定されたインスタンスに対して IDispatch::Invoke のパラメーターで記述された処理を実行します。

VTBL インターフェイスメンバーの場合、ITypeInfo::Invoke は、lcid 属性が付いたパラメーターに型情報の LCID を渡し、retval 属性に戻り値を渡します。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために基底の型記述に対して再帰的に処理を行います。

指定された型記述に対する、ドキュメント文字列、完全なヘルプファイル名およびパス、ならびにヘルプトピックのコンテキスト ID を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

GetDocumentation 関数は、memid パラメーターで指定されたメンバーのドキュメントへのアクセスを提供します。渡された memid が MEMBERID_NIL の場合、型記述のドキュメントが返されます。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために、必要に応じて基底の型記述に対して再帰的に処理を行います。

呼び出し元は、pBstrName、pBstrDocString、pBstrHelpFile が参照する BSTR を解放するために SysFreeString を使用する必要があります。

DLL 内の関数のエントリポイントの記述または仕様を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

呼び出し元は、エントリ記述を取得したいメンバー関数を表すメンバー ID を渡します。関数に DLL エントリポイントがある場合、その関数を含む DLL の名前と、その名前または序数識別子が、呼び出し元によって割り当てられた渡されたポインターに格納されます。関数に DLL エントリポイントがない場合、エラーが返されます。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために、必要に応じて基底の型記述に対して再帰的に処理を行います。

呼び出し元は、pBstrName と pBstrDllName が参照する BSTR を解放するために SysFreeString を使用する必要があります。

型記述が他の型記述を参照している場合、参照されている型記述を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

戻り値では、2 番目のパラメーターに、この型記述から参照されている型記述へのポインターへのポインターが格納されます。型記述は、その変数、関数のパラメーター、または関数の戻り値の型として現れる各型記述への参照を持たなければなりません。たとえば、データメンバーの型がレコード型である場合、そのデータメンバーの型記述には、参照されている型記述の hRefType が含まれます。型記述へのポインターを取得するには、この参照を GetRefTypeInfo に渡します。

DLL 内で定義されているような、静的関数または静的変数のアドレスを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

これらのアドレスは、呼び出し元が型記述への参照を解放するまで有効です。invKind パラメーターは、プロパティ関数のアドレスが要求されている場合を除いて無視できます。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために、必要に応じて基底の型記述に対して再帰的に処理を行います。

コンポーネントオブジェクトクラス (coclass) を記述する型の新しいインスタンスを作成します。

GetActiveObject または CoCreateInstance から追加のエラーが返される場合があります。

コンポーネントオブジェクトクラス (coclass) を記述する型の場合、CreateInstance はクラスの新しいインスタンスを作成します。通常、CreateInstance は型記述の GUID を指定して CoCreateInstance を呼び出します。Application オブジェクトの場合、まず GetActiveObject を呼び出します。アプリケーションがアクティブな場合、GetActiveObject はアクティブなオブジェクトを返します。それ以外の場合、GetActiveObject が失敗すると、CreateInstance は CoCreateInstance を呼び出します。

マーシャリング情報を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

渡されたメンバー ID が MEMBERID_NIL の場合、この関数は、型記述で記述される構造体のフィールドをマーシャリングするためのオペコード文字列を返します。それ以外の場合、インデックスで指定された関数をマーシャリングするためのオペコード文字列を返します。

型記述が別の型記述から継承している場合、この関数は、要求されたメンバー ID を持つ項目を見つけるために、必要に応じて基底の型記述に対して再帰的に処理を行います。

含まれている型ライブラリと、その型ライブラリ内における型記述のインデックスを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

ITypeInfo::GetTypeAttr で以前に返された TYPEATTR を解放します。

ITypeInfo::GetFuncDesc で以前に返された FUNCDESC を解放します。

ITypeInfo::GetVarDesc で以前に返された VARDESC を解放します。