Método IAccPropServices::ClearHwndProps (oleacc.h)
Este método encapsula SetPropValue, SetPropServer y ClearProps, y proporciona un punto de entrada conveniente para los autores de llamadas que anotan elementos accesibles basados en HWND.
Sintaxis
HRESULT ClearHwndProps(
[in] HWND hwnd,
[in] DWORD idObject,
[in] DWORD idChild,
[in] const MSAAPROPID *paProps,
[in] int cProps
);
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 se van a restablecer. Estas propiedades se revertirán al comportamiento predeterminado que presentaban antes de anotarlas.
[in] cProps
Tipo: int
Especifica el número de propiedades de la matriz paProps.
Valor devuelto
Tipo: HRESULT
Si se ejecuta correctamente, devuelve S_OK, incluso si las propiedades especificadas nunca se anotaron en el objeto accesible; Borrar propiedades ya borradas se considera un éxito.
Devuelve E_INVALIDARG si no se admite ninguna de las propiedades de la matriz paProps .
Puede devolver otros códigos de error en condiciones de error excepcionales, como memoria baja.
Para obtener descripciones de los valores devueltos, vea el método SetPropValue, SetPropServer o ClearProps correspondiente.
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 .
Además, SetHwndPropStr toma una cadena Unicode normal como parámetro; el autor de la llamada no necesita asignar especialmente un BSTR.
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 |