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

Метод IUIAutomationElement::GetRuntimeId (uiautomationclient.h)

  • Статья

Извлекает уникальный идентификатор, назначенный элементу пользовательского интерфейса.

Синтаксис

HRESULT GetRuntimeId(
  [out, retval] SAFEARRAY **runtimeId
);

Параметры

[out, retval] runtimeId

Тип: SAFEARRAY**

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

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

Тип: HRESULT

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

Комментарии

Идентификатор гарантированно будет уникальным только для пользовательского интерфейса рабочего стола, на котором он был создан. Идентификаторы могут использоваться повторно со временем.

Формат идентификаторов времени выполнения может измениться в будущем. Возвращаемый идентификатор следует рассматривать как непрозрачное значение и использовать только для сравнения; например, чтобы определить, находится ли элемент Microsoft модель автоматизации пользовательского интерфейса в кэше.

Требования

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

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

Идентификаторы свойств элемента автоматизации

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

CompareRuntimeIds

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

IUIAutomationElement

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