Поделиться через

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

  • Статья

Серверы используют SetPropServer , чтобы указать объект обратного вызова, используемый для создания примечания массива свойств для доступного элемента. Можно также указать, следует ли применять заметку к этому доступному элементу или к элементу и его дочерним элементам. Этот метод используется для заметок сервера.

Если разработчики серверов знают HWND элемента со специальными возможностями, которые они хотят добавить, они могут использовать IAccPropServices::SetHwndPropServer.

Синтаксис

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Параметры

[in] pIDString

Тип: const BYTE*

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

[in] dwIDStringLen

Тип: DWORD

Указывает длину строки, определенной параметром pIDString.

[in] paProps

Тип: const MSAAPROPID*

Указывает массив свойств, который должен обрабатываться заданным объектом обратного вызова.

[in] cProps

Тип: int

Указывает массив свойств, который должен обрабатываться заданным объектом обратного вызова.

[in] pServer

Тип: IAccPropServer*

Указывает объект обратного вызова, который должен вызываться, когда клиент запрашивает одно из переопределенных свойств.

[in] annoScope

Тип: AnnoScope

Возможные значения: ANNO_THIS, указывающее, что заметка относится только к заданному элементу, к которому осуществляется доступ; или ANNO_CONTAINER, указывающее, что она применяется к элементу и его непосредственным дочерним элементам.

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

Тип: HRESULT

Возвращает значение S_OK, если операция завершилась успешно.

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

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

Комментарии

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

Время выполнения заметки будет использовать AddRef для увеличения счетчика ссылок для объекта обратного вызова pServer соответствующим образом. Вызывающий объект может освободить его после вызова этого метода. Время выполнения заметки автоматически освобождает объект обратного вызова после того, как доступный элемент с заметками больше не используется.

Требования

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