ITypeLib::FindName メソッド (oaidl.h)
タイプ ライブラリで型の説明を検索します。 これは、タイプ ライブラリに名前が存在することを簡単に確認するために使用できます。
構文
HRESULT FindName(
[in, out] LPOLESTR szNameBuf,
[in] ULONG lHashVal,
[out] ITypeInfo **ppTInfo,
[out] MEMBERID *rgMemId,
[in, out] USHORT *pcFound
);
パラメーター
[in, out] szNameBuf
検索する名前。
[in] lHashVal
LHashValOfNameSys 関数によって計算される、検索を高速化するためのハッシュ値。 lHashVal = 0 の場合、値が計算されます。
[out] ppTInfo
szNameBuf で指定された名前を含む型の説明へのポインターの配列。 このパラメーターは null でもかまいません。
[out] rgMemId
見つかった項目の配列。 rgMemId[i] は、 ppTInfo[i] で指定された型の説明にインデックスを作成する MEMBERID です。 このパラメーターは null でもかまいません。
[in, out] pcFound
開始時に、検索するインスタンス数を示します。 たとえば、*pcFound = 1 を呼び出して、最初の出現箇所を見つけることができます。 検索が見つかると停止します。
終了時には、検索されたインスタンス数を示します。 *pcFound の入力と出力の値が同じ場合は、名前を含む型の説明が他にもある可能性があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
1 つ以上の引数が無効です。 |
|
操作を完了するためのメモリ不足。 |
注釈
*pcFound = n を渡すと、n (ptinfo, memid) ペアの ppTInfo 配列と rgMemId 配列に十分な領域があることを示します。 szNameBuf の名前が ppTInfo[i] の型情報の名前である場合、この関数は rgMemId[i] のMEMBERID_NILを返します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | oaidl.h |