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 |
|
IDL |
|