Función LresultFromObject (oleacc.h)

Devuelve una referencia, similar a un identificador, al objeto especificado. Los servidores devuelven esta referencia al controlar WM_GETOBJECT.

Sintaxis

LRESULT LresultFromObject(
  [in] REFIID    riid,
  [in] WPARAM    wParam,
  [in] LPUNKNOWN punk
);

Parámetros

[in] riid

Tipo: REFIID

Identificador de referencia de la interfaz proporcionada al cliente. Este parámetro es IID_IAccessible.

[in] wParam

Tipo: WPARAM

Valor enviado por el mensaje de WM_GETOBJECT asociado en su parámetro wParam .

[in] punk

Tipo: LPUNKNOWN

Dirección de la interfaz IAccessible al objeto que corresponde al mensaje de WM_GETOBJECT .

Valor devuelto

Tipo: LRESULT

Si se ejecuta correctamente, devuelve un valor positivo que es una referencia al objeto .

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

Código devuelto	Descripción
E_INVALIDARG	Uno o varios argumentos no son válidos.
E_NOINTERFACE	El objeto especificado en el parámetro pAcc no admite la interfaz especificada en el parámetro riid .
E_OUTOFMEMORY	Memoria insuficiente para almacenar la referencia de objeto.
E_UNEXPECTED	Se ha producido un error inesperado.

Comentarios

Los servidores llaman a esta función solo cuando se controla el mensaje de WM_GETOBJECT . Para obtener información general sobre cómo LresultFromObject está relacionado con WM_GETOBJECT, vea Cómo funciona WM_GETOBJECT.

LresultFromObject incrementa el recuento de referencias del objeto. Si no almacena el puntero de interfaz pasado a la función (es decir, crea un nuevo puntero de interfaz para el objeto cada vez que se recibe WM_GETOBJECT ), llame al método Release del objeto para disminuir el recuento de referencias a uno. A continuación, el cliente llama a Release y el objeto se destruye. Para obtener más información, vea Cómo controlar WM_GETOBJECT.

Cada vez que un servidor procesa WM_GETOBJECT para un objeto específico, llama a LresultFromObject para obtener una nueva referencia al objeto . Los servidores no guardan la referencia devuelta de LresultFromObject desde una instancia de procesamiento WM_GETOBJECT usar como valor devuelto del mensaje al procesar los mensajes de WM_GETOBJECT posteriores para el mismo objeto. Esto hace que el cliente reciba un error.

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

Consulte también

Creación de objetos de proxy

Cómo funciona WM_GETOBJECT

Cómo controlar WM_GETOBJECT

WM_GETOBJECT