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
Referenz