IWiaItem::FindItemByName メソッド (wia_xp.h)

IWiaItem::FindItemByName メソッドは、検索キーとして名前を使用して、サブアイテムの項目のツリーを検索します。 各 IWiaItem オブジェクトには、標準プロパティの 1 つとして名前があります。

構文

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

パラメーター

[in] lFlags

型: LONG

現在使用されていません。 ゼロに設定してください。

[in] bstrFullItemName

種類: BSTR

検索する項目の名前を指定します。

[out] ppIWiaItem

種類: IWiaItem**

IWiaItem インターフェイスへのポインター。

戻り値

種類: HRESULT

このメソッドは、アイテムを見つけた場合はS_OKを返し、アイテムが見つからない場合はS_FALSEを返します。 メソッドが失敗した場合は、標準の COM エラー コードが返されます。

注釈

このメソッドは、検索キーとして名前を使用して、現在のアイテムのサブアイテムのツリーを検索します。 IWiaItem::FindItemByName が bstrFullItemName で指定されたアイテムを検索すると、その項目の IWiaItem インターフェイスへのポインターのアドレスが ppIWiaItem パラメーターに格納されます。

アプリケーションは、ppIWiaItem パラメーターを介して受け取るインターフェイス ポインターで IUnknown::Release メソッドを呼び出す必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	wia_xp.h (Wia.h を含む)
Library	Wiaguid.lib
[DLL]	Wiaservc.dll