Método IAccPropServices::SetHwndPropServer (oleacc.h)
Este método encapsula SetPropServer, lo que proporciona un punto de entrada conveniente para los autores de llamadas que anotan elementos accesibles basados en HWND.
Sintaxis
HRESULT SetHwndPropServer(
[in] HWND hwnd,
[in] DWORD idObject,
[in] DWORD idChild,
[in] const MSAAPROPID *paProps,
[in] int cProps,
[in] IAccPropServer *pServer,
[in] AnnoScope annoScope
);
Parámetros
[in] hwnd
Tipo: HWND
Identifica el elemento accesible que se va a anotar. Esto reemplaza a la cadena de identidad.
[in] idObject
Tipo: DWORD
Identifica el elemento accesible que se va a anotar. Esto reemplaza a la cadena de identidad.
[in] idChild
Tipo: DWORD
Identifica el elemento accesible que se va a anotar. Esto reemplaza a la cadena de identidad.
[in] paProps
Tipo: const MSAAPROPID*
Especifica una matriz de propiedades que va a controlar el objeto de devolución de llamada especificado.
[in] cProps
Tipo: int
Especifica el número de propiedades de la matriz paProps.
[in] pServer
Tipo: IAccPropServer*
Especifica el objeto de devolución de llamada, que se invocará cuando un cliente solicite una de las propiedades reemplazadas.
[in] annoScope
Tipo: AnnoScope
Puede ser ANNO_THIS, que indica que la anotación afecta únicamente al elemento accesible indicado; o bien, puede ser ANNO_CONTAINER, que indica que se aplica al elemento y a su elemento secundario inmediato.
Valor devuelto
Tipo: HRESULT
Si se ejecuta correctamente, devuelve S_OK.
Devuelve E_INVALIDARG si alguna de las propiedades de la matriz paProps no es compatible, si la cadena de identidad no es válida o si annoScope no es una de ANNO_THIS o ANNO_CONTAINER.
Puede devolver otros códigos de error en condiciones de error excepcionales, como memoria baja.
Comentarios
Mediante este método, el autor de la llamada no tiene que obtener una cadena de identidad; puede especificar directamente los parámetros hwnd, idObject e idChild .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | oleacc.h (incluya OleAcc.h Include Initguid.h first).) |
| Archivo DLL | Oleacc.dll |
| Redistribuible | RDK de accesibilidad activa 2.0 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 98 |