Bagikan melalui

IMFAttributes::CompareItem method (mfobjects.h)

  • Artikel

Mengkueri apakah nilai atribut tersimpan sama dengan PROPVARIANT tertentu.

Sintaks

HRESULT CompareItem(
  [in]  REFGUID        guidKey,
  [in]  REFPROPVARIANT Value,
  [out] BOOL           *pbResult
);

Parameter

[in] guidKey

GUID yang mengidentifikasi nilai mana yang akan dikueri.

[in] Value

PROPVARIANT yang berisi nilai untuk dibandingkan.

[out] pbResult

Menerima nilai Boolean yang menunjukkan apakah atribut cocok dengan nilai yang diberikan dalam Nilai. Lihat Keterangan. Parameter ini tidak boleh NULL. Jika parameter ini NULL, pelanggaran akses terjadi.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.

Keterangan

Metode ini mengatur pbResult ke FALSE karena salah satu alasan berikut:

  • Tidak ada atribut yang ditemukan yang kuncinya cocok dengan yang diberikan dalam guidKey.
  • Jenis PROPVARIANT atribut tidak cocok dengan jenis yang diberikan dalam Nilai.
  • Nilai atribut tidak cocok dengan nilai yang diberikan dalam Nilai.
  • Metode gagal.
Jika tidak, metode mengatur pbResult ke TRUE.

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfobjects.h (termasuk Mfidl.h)
Pustaka Mfuuid.lib

Lihat juga

Atribut dan Properti

IMFAttributes