Metode ITypeLib::FindName (oaidl.h)

Menemukan kemunculan deskripsi tipe dalam pustaka tipe. Ini dapat digunakan untuk memverifikasi dengan cepat bahwa nama ada di pustaka jenis.

Sintaks

HRESULT FindName(
  [in, out] LPOLESTR  szNameBuf,
  [in]      ULONG     lHashVal,
  [out]     ITypeInfo **ppTInfo,
  [out]     MEMBERID  *rgMemId,
  [in, out] USHORT    *pcFound
);

Parameter

[in, out] szNameBuf

Nama yang akan dicari.

[in] lHashVal

Nilai hash untuk mempercepat pencarian, dihitung oleh fungsi LHashValOfNameSys . Jika lHashVal = 0, nilai dihitung.

[out] ppTInfo

Array pointer ke deskripsi jenis yang berisi nama yang ditentukan dalam szNameBuf. Parameter ini tidak boleh null.

[out] rgMemId

Array item yang ditemukan; rgMemId[i] adalah MEMBERID yang mengindeks ke dalam deskripsi jenis yang ditentukan oleh ppTInfo[i]. Parameter ini tidak boleh null.

[in, out] pcFound

Pada entri, menunjukkan berapa banyak instans yang harus dicari. Misalnya, *pcFound = 1 dapat dipanggil untuk menemukan kejadian pertama. Pencarian berhenti ketika pencarian ditemukan.

Saat keluar, menunjukkan jumlah instans yang ditemukan. Jika nilai masuk dan keluar *pcFound identik, mungkin ada lebih banyak deskripsi jenis yang berisi nama.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Keterangan

Melewati *pcFound = n menunjukkan bahwa ada cukup ruang di array ppTInfo dan rgMemId untuk pasangan n (ptinfo, memid). Fungsi mengembalikan MEMBERID_NIL di rgMemId[i], jika nama di szNameBuf adalah nama informasi jenis di ppTInfo[i].

Persyaratan

Lihat juga

ITypeLib