IAccessibleEx::GetRuntimeId-Methode (uiautomationcore.h)

Ruft den Laufzeitbezeichner dieses Elements ab.

Syntax

HRESULT GetRuntimeId(
  [out] SAFEARRAY **pRetVal
);

Parameter

[out] pRetVal

Typ: SAFEARRAY**

Empfängt einen Zeiger auf den Laufzeitbezeichner.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Laufzeitbezeichner ist ein vom Anbieter definiertes Array von ganzen Zahlen, deren erstes Element UiaAppendRuntimeId sein muss. Der Laufzeitbezeichner muss innerhalb des übergeordneten Fensters eindeutig sein.

Der MSAA-zu-UIA-Proxy verwendet den Laufzeitbezeichner (zusammen mit dem Fensterhandle), um zu bestimmen, ob zwei Schnittstelleninstanzen auf dasselbe zugrunde liegende Element verweisen. Wenn IAccessibleEx::GetRuntimeId nicht implementiert ist, führt der Proxy Feld-für-Feld-Vergleiche für die beiden IAccessible-Objekte durch, um zu bestimmen, ob sie gleichwertig sind, was weniger effizient ist.

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 [Desktop-Apps | UWP-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 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

Konzept

IAccessibleEx

Referenz