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

Статья
08/25/2023

Этот метод заключает в оболочку SetPropValue, SetPropServer и ClearProps, а также предоставляет удобную точку входа для вызывающих лиц, которые помечают доступные элементы на основе HWND.

Синтаксис

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Параметры

[in] hwnd

Тип: HWND

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

[in] idObject

Тип: DWORD

[in] idChild

Тип: DWORD

[in] paProps

Тип: const MSAAPROPID*

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

[in] cProps

Тип: int

Указывает число свойств в массиве paProps.

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

Тип: HRESULT

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

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

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

Описания возвращаемых значений см. в соответствующем методе SetPropValue, SetPropServer или ClearProps .

Требования

Требование	Значение
Минимальная версия клиента	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