Metode IWICMetadataQueryReader::GetMetadataByName (wincodec.h)

Artikel
03/13/2024

Mengambil blok metadata atau item yang diidentifikasi oleh ekspresi kueri metadata.

Sintaks

HRESULT GetMetadataByName(
  [in]      LPCWSTR     wzName,
  [in, out] PROPVARIANT *pvarValue
);

Parameter

[in] wzName

Jenis: LPCWSTR

Ekspresi kueri ke blok metadata atau item yang diminta.

[in, out] pvarValue

Jenis: PROPVARIANT*

Ketika metode ini kembali, berisi blok metadata atau item yang diminta.

Nilai kembali

Jenis: HRESULT

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

Keterangan

GetMetadataByName menggunakan ekspresi kueri metadata untuk mengakses metadata yang disematkan. Untuk informasi selengkapnya tentang bahasa kueri metadata, lihat Gambaran Umum Bahasa Kueri Metadata.

Jika ada beberapa blok atau item yang dinyatakan oleh ekspresi kueri yang sama, blok metadata atau item pertama yang ditemukan akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll