IWiaItem2::FindItemByName method

Searches an item's tree of subitems using the name as the search key.

Syntax

HRESULT FindItemByName(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrFullItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Parameters

lFlags [in]

Type: LONG

Currently unused. Should be set to zero.

bstrFullItemName [in]

Type: BSTR

Specifies the name fo the item to search for.

ppIWiaItem2 [out]

Type: IWiaItem2**

Receives the address of a pointer to the IWiaItem2 interface of the item found.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method searches the current item's tree of sub-items using the name as the search key. If IWiaItem2::FindItemByName finds the item specified by bstrFullItemName, it stores the address of a pointer to the IWiaItem2 interface of the item in the ppIWiaItem2 parameter.

Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIWiaItem2 parameter.

Requirements