Метод IAccPropServices::ClearProps (oleacc.h)

Серверы используют ClearProps для восстановления значений по умолчанию свойств доступных элементов, которые они ранее аннотировали.

Если серверы знают HWND объекта, который они хотят очистить, они могут использовать IAccPropServices::ClearHwndProps.

Синтаксис

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

Параметры

[in] pIDString

Тип: const BYTE*

Определяет элемент, к которому осуществляется доступ, для удаления заметки.

[in] dwIDStringLen

Тип: DWORD

Длина pIDString.

[in] paProps

Тип: const MSAAPROPID*

Указывают массив свойств, который необходимо сбросить. Данные свойства будут возвращены к поведению по умолчанию, которому они следовали до создания для них заметок.

[in] cProps

Тип: int

Размер массива paProps .

Возвращаемое значение

Тип: HRESULT

В случае успешного выполнения возвращает S_OK, даже если указанные свойства никогда не были помечены доступным объектом; Очистка уже очищенных свойств считается успешной.

Возвращает E_INVALIDARG, если какие-либо свойства в массиве paProps не поддерживаются.

Может возвращать другие коды ошибок при исключительных условиях ошибок, таких как нехватка памяти.

Комментарии

Список поддерживаемых свойств и их ожидаемых типов см. в разделе поддержки.

Удаление заметки для свойства приведет к освобождению всех связанных ресурсов. Если использовался сервер свойств обратного вызова (см. SetPropServer), он будет освобожден.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	oleacc.h (сначала включите OleAcc.h Include Initguid.h.)
DLL	Oleacc.dll
Распространяемые компоненты	Активные специальные возможности 2.0 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 98