Метод IAccPropServices::ClearHwndProps (oleacc.h)
Этот метод заключает в оболочку 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 .
Комментарии
При использовании этого метода вызывающей объекту не требуется получать строку удостоверения; он может указывать параметры hwnd, idObject и idChild напрямую.
Кроме того, SetHwndPropStr принимает обычную строку Юникода в качестве параметра; вызывающей объекту не нужно специально выделять BSTR.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | 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 |