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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| Header |
|
| IDL |
|