METODE IMFAttributes::GetItem (mfobjects.h)
Mengambil nilai yang terkait dengan kunci.
Sintaks
HRESULT GetItem(
[in] REFGUID guidKey,
[in, out] PROPVARIANT *pValue
);
Parameter
[in] guidKey
GUID yang mengidentifikasi nilai mana yang akan diambil.
[in, out] pValue
Pointer ke PROPVARIANT yang menerima nilai . Metode mengisi PROPVARIANT dengan salinan nilai yang disimpan, jika nilai ditemukan. Panggil PropVariantClear untuk membebaskan memori yang dialokasikan oleh metode ini. Parameter ini bisa NULL. Jika parameter ini NULL, metode mencari kunci dan mengembalikan S_OK jika kunci ditemukan, tetapi tidak menyalin nilai.
Nilai kembali
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Kunci yang ditentukan tidak ditemukan. |
Keterangan
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.
Contoh
Contoh berikut menyalin atribut dari satu penyimpanan atribut ke penyimpanan atribut lainnya.
HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
PROPVARIANT val;
HRESULT hr = pFrom->GetItem(guidKey, &val);
if (SUCCEEDED(hr))
{
hr = pTo->SetItem(guidKey, val);
PropVariantClear(&val);
}
else if (hr == MF_E_ATTRIBUTENOTFOUND)
{
hr = S_OK;
}
return hr;
}
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk