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

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

Синтаксис

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.

Комментарии

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.

Требования