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

O método AccessibleObjectFromID recupera um ponteiro de interface IAccessible para a interface associada à ID de objeto fornecida. Oleacc.dll usa esse método para obter um ponteiro de interface IAccessible para proxies fornecidos por outro código.

ObservaçãoIAccessibleHandler::AccessibleObjectFromID foi preterido e não deve ser usado.

 

Sintaxe

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

Parâmetros

[in] hwnd

Tipo: long

Especifica o identificador de uma janela para a qual um ponteiro de interface IAccessible deve ser recuperado.

[in] lObjectID

Tipo: long

Especifica a ID do objeto. Esse valor é uma das constantes de identificador de objeto padrão ou uma ID de objeto personalizada.

[out] pIAccessible

Tipo: LPACCESSIBLE*

Especifica o endereço de uma variável de ponteiro que recebe o endereço da interface IAccessible do objeto.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará um dos seguintes ou outro código de erro COM padrão.

Erro	Descrição
E_INVALIDARG	Um argumento não é válido.
E_NOINTERFACE	Não há suporte para a interface solicitada.

Comentários

Oleacc chama essa função para obter um ponteiro de interface IAccessible para HWNDsque têm o nome de classe para o qual esse manipulador está registrado.

Na inicialização, o Oleacc examina a chave do Registro HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers e enumera em cada subchave (Oleacc espera que a subchave seja um GUID). Oleacc lê o nome da classe associada de HKCR\CLSID{guid}\AccClassName, em que {guid} foi o GUID encontrado na chave HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers. Quando o Oleacc encontra uma janela com um nome de classe que corresponde ao GUID, ele cocria o objeto usando o GUID, recupera o ponteiro da interface IAccessibleHandler e chama AccessibleObjectFromID para obter o ponteiro da interface IAccessible .

Assim como acontece com outros métodos e funções IAccessible , os clientes podem receber erros para ponteiros de interface IAccessible devido a uma ação do usuário. Para obter mais informações, consulte Recebendo erros para ponteiros de interface IAccessible.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleacc.h
Biblioteca	Oleacc.lib
DLL	Oleacc.dll
Redistribuível	Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95