Metode IWiaItem2::FindItemByName

Artikel
06/12/2023

Mencari pohon subitem item menggunakan nama sebagai kunci pencarian.

Sintaks

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

Parameter

lFlags [in]

Jenis: LONG

Saat ini tidak digunakan. Harus diatur ke nol.

bstrFullItemName [in]

Jenis: BSTR

Menentukan nama untuk item yang akan dicari.

ppIWiaItem2 [out]

Jenis: IWiaItem2**

Menerima alamat pointer ke antarmuka IWiaItem2 dari item yang ditemukan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini mencari pohon sub-item item saat ini menggunakan nama sebagai kunci pencarian. Jika IWiaItem2::FindItemByName menemukan item yang ditentukan oleh bstrFullItemName, item menyimpan alamat pointer ke antarmuka IWiaItem2 item dalam parameter ppIWiaItem2 .

Aplikasi harus memanggil metode IUnknown::Release pada pointer antarmuka yang mereka terima melalui parameter ppIWiaItem2 .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl

Share via