Поделиться через

Метод IAccessibleEx::GetRuntimeId (uiautomationcore.h)

  • Статья

Извлекает идентификатор среды выполнения этого элемента.

Синтаксис

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

Параметры

[out] pRetVal

Тип: SAFEARRAY**

Получает указатель на идентификатор среды выполнения.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Идентификатор среды выполнения — это определяемый поставщиком массив целых чисел, первым элементом которого должен быть UiaAppendRuntimeId. Идентификатор среды выполнения должен быть уникальным в пределах родительского окна.

Прокси-сервер MSAA—UIA использует идентификатор среды выполнения (вместе с дескриптором окна), чтобы определить, ссылаются ли два экземпляра интерфейса на один и тот же базовый элемент. Если IAccessibleEx::GetRuntimeId не реализован, прокси-сервер выполняет сравнение полей по полю для двух объектов IAccess , чтобы определить, эквивалентны ли они, что менее эффективно.

Требования

   
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и Обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcore.h (включая UIAutomation.h)

См. также раздел

Рекомендации по использованию безопасных массивов

Основные понятия

IAccessibleEx

Справочные материалы