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 |
|---|---|
|
Uno o varios argumentos no son válidos. |
|
El objeto especificado en el parámetro pAcc no admite la interfaz especificada en el parámetro riid . |
|
Memoria insuficiente para almacenar la referencia de objeto. |
|
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 |