ITfContext::GetAppProperty-Methode (msctf.h)

Ruft eine Anwendungseigenschaft ab.

Syntax

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

Parameter

[in] guidProp

Gibt den Eigenschaftenbezeichner an. Dies kann ein benutzerdefinierter Bezeichner oder einer der vordefinierten Eigenschaftenbezeichner sein.

[out] ppProp

Zeiger auf einen ITfReadOnlyProperty-Schnittstellenzeiger , der das Eigenschaftsobjekt empfängt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Der Kontextbesitzer unterstützt die Eigenschaft nicht.
TF_E_DISCONNECTED	Der Kontext befindet sich nicht in einem Dokumentstapel.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_OUTOFMEMORY	Ein Speicherbelegungsfehler ist aufgetreten.
E_NOTIMPL	Der Kontextbesitzer implementiert diese Methode nicht.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Anwendungen können eindeutige Eigenschaften definieren, die durch eine GUID identifiziert werden. Eigenschaften werden als VARIANT-Daten gespeichert, sodass der Aufrufer das Format und die Bedeutung eindeutiger Eigenschaften erkennen muss, um sie verwenden zu können.

Anwendungseigenschaften unterscheiden sich von Texteigenschaften, die von ITfContext::GetProperty abgerufen werden, da Anwendungseigenschaften vom Kontextbesitzer verwaltet werden und nicht von einem Textdienst geändert werden können. Anwendungseigenschaften können nur vom Kontextbesitzer geändert werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfContext-Schnittstelle, ITfContext::GetProperty, ITfReadOnlyProperty-Schnittstelle, Vordefinierte Eigenschaften