Метод IAccessibleHandler::AccessibleObjectFromID (oleacc.h)

  • Статья

Метод AccessibleObjectFromID извлекает указатель интерфейса IAccessible для интерфейса, связанного с заданным идентификатором объекта. Oleacc.dll использует этот метод для получения указателя интерфейса IAccessible для прокси-серверов, предоставляемых другим кодом.

Примечание. IAccessibleHandler::AccessibleObjectFromID не рекомендуется использовать.
 

Синтаксис

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

Параметры

[in] hwnd

Тип: long

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

[in] lObjectID

Тип: long

Указывает идентификатор объекта. Это значение является одной из стандартных констант идентификатора объекта или пользовательским идентификатором объекта.

[out] pIAccessible

Тип: LPACCESSIBLE*

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

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

Тип: HRESULT

Возвращает значение S_OK, если операция завершилась успешно.

В случае успеха возвращает один из следующих или другой стандартный код ошибки COM.

Ошибка Описание
E_INVALIDARG
 Аргумент является недопустимым.
E_NOINTERFACE
 Запрошенный интерфейс не поддерживается.

Комментарии

Oleacc вызывает эту функцию, чтобы получить указатель интерфейса IAccessible для HWND, имеющих имя класса, для которых зарегистрирован этот обработчик.

При запуске Oleacc выполняет поиск в разделе реестра HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers и выполняет перечисление по каждому подразделу (Oleacc ожидает, что подраздел будет GUID). Oleacc считывает связанное имя класса из HKCR\CLSID{guid}\AccClassName, где {guid} — это GUID, найденный в ключе HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers. Когда Oleacc находит окно с именем класса, соответствующим GUID, он coCreate объект с помощью GUID, извлекает указатель интерфейса IAccessibleHandler и вызывает AccessibleObjectFromID для получения указателя интерфейса IAccessible .

Как и в случае с другими методами и функциями IAccess , клиенты могут получать ошибки для указателей интерфейса IAccess из-за действия пользователя. Дополнительные сведения см. в разделе Получение ошибок для указателей интерфейса IAccessible.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header oleacc.h
Библиотека Oleacc.lib
DLL Oleacc.dll
Распространяемые компоненты Активные специальные возможности 1.3 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 95