Condividi tramite


Metodo IWiaItem2::FindItemByName

Cerca l'albero di elementi secondari di un elemento usando il nome come chiave di ricerca.

Sintassi

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

Parametri

lFlags [in]

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

bstrFullItemName [in]

Tipo: BSTR

Specifica il nome dell'elemento da cercare.

ppIWiaItem2 [out]

Tipo: IWiaItem2**

Riceve l'indirizzo di un puntatore all'interfaccia IWiaItem2 dell'elemento trovato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

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

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

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]
Intestazione
Wia.h
IDL
Wia.idl