Método IAccessibleHandler::AccessibleObjectFromID (oleacc.h)

El método AccessibleObjectFromID recupera un puntero de interfaz IAccessible para la interfaz asociada al identificador de objeto especificado. Oleacc.dll usa este método para obtener un puntero de interfaz IAccessible para servidores proxy proporcionados por otro código.

NotaIAccessibleHandler::AccessibleObjectFromID está en desuso y no se debe usar.

 

Sintaxis

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

Parámetros

[in] hwnd

Tipo: long

Especifica el identificador de una ventana para la que se va a recuperar un puntero de interfaz IAccessible .

[in] lObjectID

Tipo: long

Especifica el id. de objeto. Este valor es una de las constantes de identificador de objeto estándar o un identificador de objeto personalizado.

[out] pIAccessible

Tipo: LPACCESSIBLE*

Especifica la dirección de una variable de puntero que recibe la dirección de la interfaz IAccessible del objeto.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Si no se ejecuta correctamente, devuelve uno de los siguientes u otro código de error COM estándar.

Error	Descripción
E_INVALIDARG	Un argumento no es válido.
E_NOINTERFACE	La interfaz solicitada no es compatible.

Comentarios

Oleacc llama a esta función para obtener un puntero de interfaz IAccessible para los S HWNDque tienen el nombre de clase para el que está registrado este controlador.

En el inicio, Oleacc busca en la clave del Registro HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers y enumera sobre cada subclave (Oleacc espera que la subclave sea un GUID). Oleacc lee el nombre de clase asociado de HKCR\CLSID{guid}\AccClassName, donde {guid} era el GUID encontrado en la clave HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers. Cuando Oleacc encuentra una ventana con un nombre de clase que coincide con el GUID, CoCreate el objeto mediante el GUID, recupera el puntero de interfaz IAccessibleHandler y llama a AccessibleObjectFromID en él para obtener en el puntero de interfaz IAccessible .

Al igual que con otros métodos y funciones IAccessible , los clientes pueden recibir errores para punteros de interfaz IAccessible debido a una acción del usuario. Para obtener más información, vea Recepción de errores para punteros de interfaz IAccessible.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleacc.h
Library	Oleacc.lib
Archivo DLL	Oleacc.dll
Redistribuible	RDK de accesibilidad activa 1.3 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 95