Metode ITfContext::GetAppProperty (msctf.h)

Mendapatkan properti aplikasi.

Sintaks

HRESULT GetAppProperty(
  [in]  REFGUID             guidProp,
  [out] ITfReadOnlyProperty **ppProp
);

Parameter

[in] guidProp

Menentukan pengidentifikasi properti. Ini bisa menjadi pengidentifikasi kustom atau salah satu pengidentifikasi properti yang telah ditentukan sebelumnya.

[out] ppProp

Penunjuk ke penunjuk antarmuka ITfReadOnlyProperty yang menerima objek properti.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
Metode berhasil.
S_FALSE
Pemilik konteks tidak mendukung properti .
TF_E_DISCONNECTED
Konteks tidak ada di tumpukan dokumen.
E_INVALIDARG
Satu atau beberapa parameter tidak valid.
E_OUTOFMEMORY
Terjadi kegagalan alokasi memori.
E_NOTIMPL
Pemilik konteks tidak menerapkan metode ini.
E_FAIL
Terjadi kesalahan yang tidak ditentukan.

Keterangan

Aplikasi dapat menentukan properti unik yang diidentifikasi oleh GUID. Properti disimpan sebagai data VARIAN, sehingga pemanggil harus mengenali format dan arti properti unik agar dapat menggunakannya.

Properti aplikasi berbeda dari properti teks, yang diperoleh oleh ITfContext::GetProperty, dalam hal itu, properti aplikasi dikelola oleh pemilik konteks dan tidak dapat dimodifikasi oleh layanan teks. Properti aplikasi hanya dapat dimodifikasi oleh pemilik konteks.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header msctf.h
DLL Msctf.dll
Redistribusi TSF 1.0 di Windows 2000 Professional

Lihat juga

Antarmuka ITfContext, ITfContext::GetProperty, antarmuka ITfReadOnlyProperty, Properti yang Telah Ditentukan Sebelumnya