Função LresultFromObject (oleacc.h)
Retorna uma referência, semelhante a um identificador, ao objeto especificado. Os servidores retornam essa referência ao lidar com WM_GETOBJECT.
Sintaxe
LRESULT LresultFromObject(
[in] REFIID riid,
[in] WPARAM wParam,
[in] LPUNKNOWN punk
);
Parâmetros
[in] riid
Tipo: REFIID
Identificador de referência da interface fornecida ao cliente. Esse parâmetro é IID_IAccessible.
[in] wParam
Tipo: WPARAM
Valor enviado pela mensagem de WM_GETOBJECT associada em seu parâmetro wParam .
[in] punk
Tipo: LPUNKNOWN
Endereço da interface IAccessible para o objeto que corresponde à mensagem WM_GETOBJECT .
Retornar valor
Tipo: LRESULT
Se tiver êxito, retornará um valor positivo que é uma referência ao objeto .
Se não for bem-sucedido, retornará um dos valores na tabela a seguir ou outro código de erro COM padrão.
| Código de retorno | Descrição |
|---|---|
|
Um ou mais argumentos não são válidos. |
|
O objeto especificado no parâmetro pAcc não dá suporte à interface especificada no parâmetro riid . |
|
Memória insuficiente para armazenar a referência de objeto. |
|
Erro inesperado. |
Comentários
Os servidores chamam essa função somente ao lidar com a mensagem WM_GETOBJECT . Para obter uma visão geral de como LresultFromObject está relacionado a WM_GETOBJECT, consulte Como WM_GETOBJECT funciona.
LresultFromObject incrementa a contagem de referência do objeto. Se você não estiver armazenando o ponteiro de interface passado para a função (ou seja, você criará um ponteiro de interface para o objeto sempre que WM_GETOBJECT for recebido), chame o método Release do objeto para diminuir a contagem de referência de volta para um. Em seguida, o cliente chama Release e o objeto é destruído. Para obter mais informações, consulte Como lidar com WM_GETOBJECT.
Cada vez que um servidor processa WM_GETOBJECT para um objeto específico, ele chama LresultFromObject para obter uma nova referência ao objeto . Os servidores não salvam a referência retornada de LresultFromObject de uma instância de processamento WM_GETOBJECT para usar como o valor retornado da mensagem ao processar mensagens WM_GETOBJECT subsequentes para o mesmo objeto. Isso faz com que o cliente receba um erro.
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 |