Metodo IWiaItem::FindItemByName (wia_xp.h)

Il metodo IWiaItem::FindItemByName cerca nell'albero di elementi secondari di un elemento usando il nome come chiave di ricerca. Ogni oggetto IWiaItem ha un nome come una delle relative proprietà standard.

Sintassi

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

Parametri

[in] lFlags

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

[in] bstrFullItemName

Tipo: BSTR

Specifica il nome dell'elemento in cui eseguire la ricerca.

[out] ppIWiaItem

Tipo: IWiaItem**

Puntatore all'interfaccia IWiaItem .

Valore restituito

Tipo: HRESULT

Questo metodo restituisce S_OK se trova l'elemento o S_FALSE se non trova l'elemento. Se il metodo ha esito negativo, restituisce un codice di errore COM standard.

Commenti

Questo metodo esegue la ricerca nell'albero dell'elemento corrente di elementi secondari usando il nome come chiave di ricerca. Se IWiaItem::FindItemByName trova l'elemento specificato da bstrFullItemName, archivia l'indirizzo di un puntatore all'interfaccia IWiaItem dell'elemento nel parametro ppIWiaItem .

Le applicazioni devono chiamare il metodo IUnknown::Release sui puntatori di interfaccia ricevuti tramite il parametro ppIWiaItem .

Requisiti