Metode IWiaDrvItem::FindItemByName (wiamindr_lh.h)
Metode IWiaDrvItem::FindItemByName menemukan item di pohon item driver dengan nama lengkap item.
Sintaks
HRESULT FindItemByName(
LONG __MIDL__IWiaDrvItem0007,
BSTR __MIDL__IWiaDrvItem0008,
IWiaDrvItem **__MIDL__IWiaDrvItem0009
);
Parameter
__MIDL__IWiaDrvItem0007
bstrFullItemName [in]
Menentukan nama lengkap item yang akan ditemukan.
__MIDL__IWiaDrvItem0008
lFlags [in]
Dicadangkan. Atur ke nol.
__MIDL__IWiaDrvItem0009
ppItem [keluar, opsional]
Menunjuk ke lokasi memori yang akan menerima alamat item IWiaDrvItem yang ditemukan.
Mengembalikan nilai
Jika metode berhasil, metode menyimpan pointer ke item yang ditemukan di ppItem dan mengembalikan S_OK. Jika metode gagal, metode menempatkan NULL di ppItem dan mengembalikan S_FALSE. Jika metode ini tidak menemukan item yang diperlukan, maka akan mengembalikan S_FALSE. Jika terjadi kesalahan selama pencarian, kode kesalahan COM standar akan dikembalikan.
Keterangan
Minidriver memanggil metode ini untuk menemukan item di pohon item driver ketika nama lengkap item diketahui. Nama lengkap item diperoleh dalam metode IWiaDrvItem::GetFullItemName.
Metode ini memulai pencarian item yang ditentukan pada item akar di pohon item driver.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |