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

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

  • Статья

Этот метод используется для определения HWND, идентификатора объекта и дочернего идентификатора для доступного элемента, определяемого строкой удостоверения.

Синтаксис

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

Параметры

[in] pIDString

Тип: const BYTE*

Указатель на буфер, содержащий строку удостоверения элемента, доступного на основе HWND.

[in] dwIDStringLen

Тип: DWORD

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

[out] phwnd

Тип: HWND*

Указатель на буфер, получающий HWND доступного элемента.

[out] pidObject

Тип: DWORD*

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

[out] pidChild

Тип: DWORD*

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

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

Тип: HRESULT

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

Возвращает E_INVALIDARG, если phwnd, pidObject или pidChild недопустимы, или если заданная строка удостоверения не является строкой удостоверения на основе HWND.

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

Комментарии

Этот метод завершается успешно, только если указанная строка удостоверения является строкой удостоверения на основе HWND. Этот метод полезен при использовании на сервере обратного вызова IAccPropServer, зарегистрированном в ANNO_CONTAINER область так как он позволяет серверу определять из заданной строки удостоверения дочерний элемент (idChild), для которого клиент вызывает сервер.

Требования

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