Metode IWICMetadataQueryWriter::SetMetadataByName (wincodec.h)

Artikel
03/13/2024

Mengatur item metadata ke lokasi tertentu.

Sintaks

HRESULT SetMetadataByName(
  [in] LPCWSTR           wzName,
  [in] const PROPVARIANT *pvarValue
);

Parameter

[in] wzName

Jenis: LPCWSTR

Nama item metadata.

[in] pvarValue

Jenis: const PROPVARIANT*

Metadata yang akan diatur.

Nilai kembali

Jenis: HRESULT

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

Keterangan

SetMetadataByName menggunakan ekspresi kueri metadata untuk menghapus metadata. Untuk informasi selengkapnya tentang bahasa kueri metadata, lihat Gambaran Umum Bahasa Kueri Metadata.

Jika kumpulan nilai adalah blok metadata berlapis, gunakan jenis VT_UNKNOWN varian dan pvarValue yang menunjuk ke IWICMetadataQueryWriter dari blok metadata baru.
Pengurutan item metadata adalah atas kebijakan penulis kueri karena lokasi relatif tidak ditentukan.

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