Compartir a través de

Método IAccPropServices::ClearProps (oleacc.h)

  • Artículo

Los servidores usan ClearProps para restaurar los valores predeterminados en las propiedades de los elementos accesibles que habían anotado anteriormente.

Si los servidores conocen el HWND del objeto que quieren borrar, pueden usar IAccPropServices::ClearHwndProps.

Sintaxis

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parámetros

[in] pIDString

Tipo: const BYTE*

Identifica el elemento accesible en el que se van a anular las anotaciones.

[in] dwIDStringLen

Tipo: DWORD

Longitud de pIDString.

[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

Tamaño 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 las propiedades ya borradas se considera correcta.

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.

Comentarios

Consulte la sección de soporte técnico para obtener una lista de las propiedades admitidas y sus tipos esperados.

Borrar la anotación de una propiedad hará que se libere cualquier recurso asociado. Si se usó un servidor de propiedades de devolución de llamada (consulte SetPropServer), se liberará.

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