IWiaDrvItem::FindItemByName method (wiamindr_lh.h)

The IWiaDrvItem::FindItemByName method locates an item in a driver item tree by the item's full name.

Syntax

HRESULT FindItemByName(
  LONG        __MIDL__IWiaDrvItem0007,
  BSTR        __MIDL__IWiaDrvItem0008,
  IWiaDrvItem **__MIDL__IWiaDrvItem0009
);

Parameters

__MIDL__IWiaDrvItem0007

bstrFullItemName [in]

Specifies the full name of the item to find.

__MIDL__IWiaDrvItem0008

lFlags [in]

Reserved. Set to zero.

__MIDL__IWiaDrvItem0009

ppItem [out, optional]

Points to a memory location that will receive the address of the found IWiaDrvItem item.

Return value

If the method succeeds, it stores a pointer to the found item in ppItem and returns S_OK. If the method fails, it places NULL in ppItem and returns S_FALSE. If this method does not find the required item, it returns S_FALSE. If an error occurred during the search, a standard COM error code will be returned.

Remarks

Minidrivers call this method to find an item in a driver item tree when the item's full name is known. The item's full name is obtained in the method IWiaDrvItem::GetFullItemName.

This method starts the search for the specified item at the root item in the driver item tree.

Requirements

See also

IWiaDrvItem

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName