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 の入力と出力の値が同じ場合は、名前を含む型の説明が他にもある可能性があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_ok
正常終了しました。
E_INVALIDARG
1 つ以上の引数が無効です。
E_OUTOFMEMORY
操作を完了するためのメモリ不足。

注釈

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

要件

要件 値
対象プラットフォーム Windows
ヘッダー oaidl.h

こちらもご覧ください

ITypeLib