METODE IMFAttributes::SetItem (mfobjects.h)

  • Artikel

Menambahkan nilai atribut dengan kunci tertentu.

Sintaks

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

Parameter

[in] guidKey

GUID yang mengidentifikasi nilai yang akan ditetapkan. Jika kunci ini sudah ada, metode akan menimpa nilai lama.

[in] Value

PROPVARIANT yang berisi nilai atribut. Metode menyalin nilai. Jenis PROPVARIANT harus salah satu jenis yang tercantum dalam enumerasi MF_ATTRIBUTE_TYPE .

Nilai kembali

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

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_OUTOFMEMORY
 Memori tidak cukup.
MF_E_INVALIDTYPE
 Jenis atribut tidak valid.

Keterangan

Metode ini memeriksa apakah jenis PROPVARIANT adalah salah satu jenis atribut yang ditentukan dalam MF_ATTRIBUTE_TYPE, dan gagal jika jenis yang tidak didukung digunakan. Namun, metode ini tidak memeriksa apakah PROPVARIANT adalah jenis yang benar untuk GUID atribut yang ditentukan. (Tidak ada cara terprogram untuk mengaitkan GUID atribut dengan jenis properti.) Untuk daftar atribut Media Foundation dan jenis datanya, lihat Atribut Media Foundation.

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