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

Статья
08/26/2023

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

Синтаксис

HRESULT GetCurrentPatternAs(
  [in]  PATTERNID patternId,
  [in]  REFIID    riid,
  [out] void      **patternObject
);

Параметры

[in] patternId

Тип: PATTERNID

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

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого через ppv.

[out] patternObject

Тип: void**

Получает указатель интерфейса, запрошенный в riid.

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

Тип: HRESULT

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

Рекомендуется использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный IID на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кода.

Требования

Требование	Значение
Минимальная версия клиента	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)