IUIAutomationElement::GetCachedPropertyValue-Methode (uiautomationclient.h)

Ruft einen Eigenschaftswert aus dem Cache für dieses Ui Automation-Element ab.

Syntax

HRESULT GetCachedPropertyValue(
  [in]          PROPERTYID propertyId,
  [out, retval] VARIANT    *retVal
);

Parameter

[in] propertyId

Typ: PROPERTYID

Der Bezeichner der Eigenschaft. Eine Liste der Eigenschaften-IDs finden Sie unter Eigenschaftenbezeichner.

[out, retval] retVal

Typ: VARIANT*

Empfängt den Wert der zwischengespeicherten Eigenschaft.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Microsoft UI Automation-Eigenschaften des double-Typs unterstützen Not a Number (NaN)-Werte. Beim Abrufen einer Eigenschaft vom Typ double kann ein Client die funktion _isnan verwenden, um zu bestimmen, ob es sich bei der Eigenschaft um einen NaN-Wert handelt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Siehe auch

Konzept

GetCachedPropertyValueEx

Getcurrentpropertyvalue

IUIAutomationElement

Referenz

Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften