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.
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 |
---|---|
|
Um argumento não é válido. |
|
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 |