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
E_INVALIDARG	Um ou mais argumentos não são válidos.
E_NOINTERFACE	O objeto especificado no parâmetro pAcc não dá suporte à interface especificada no parâmetro riid .
E_OUTOFMEMORY	Memória insuficiente para armazenar a referência de objeto.
E_UNEXPECTED	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

Confira também

Criando objetos proxy

Como WM_GETOBJECT funciona

Como lidar com WM_GETOBJECT

WM_GETOBJECT