IMFAttributes::GetAllocatedString method (mfobjects.h)

  • Artikel

Mendapatkan string karakter lebar yang terkait dengan kunci. Metode ini mengalokasikan memori untuk string.

Sintaks

HRESULT GetAllocatedString(
  [in]  REFGUID guidKey,
  [out] LPWSTR  *ppwszValue,
  [out] UINT32  *pcchLength
);

Parameter

[in] guidKey

GUID yang mengidentifikasi nilai mana yang akan diambil. Jenis atribut harus MF_ATTRIBUTE_STRING.

[out] ppwszValue

Jika kunci ditemukan dan nilainya adalah jenis string, parameter ini menerima salinan string. Pemanggil harus membebaskan memori untuk string dengan memanggil CoTaskMemFree.

[out] pcchLength

Menerima jumlah karakter dalam string, tidak termasuk karakter NULL yang mengakhiri. Parameter ini tidak boleh NULL.

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.
MF_E_ATTRIBUTENOTFOUND
 Kunci yang ditentukan tidak ditemukan.
MF_E_INVALIDTYPE
 Nilai atribut bukan string.

Keterangan

Untuk menyalin nilai string ke buffer yang dialokasikan pemanggil, gunakan metode IMFAttributes::GetString .

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.
Catatan Versi dokumentasi yang lebih lama salah menyatakan bahwa parameter pcchLength dapat berupa NULL. Mengatur parameter ini ke NULL mungkin berhasil dalam beberapa kasus, tetapi tidak dijamin. Pemanggil harus meneruskan pointer non-NULL untuk parameter ini.
 

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

MF_ATTRIBUTE_TYPE