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

Вызывающие абоненты используют ComposeHwndIdentityString для получения строки удостоверения.

Синтаксис

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Параметры

[in] hwnd

Тип: HWND

Указывает HWND элемента, доступного для идентификации вызывающего объекта.

[in] idObject

Тип: DWORD

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

[in] idChild

Тип: DWORD

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

[out] ppIDString

Тип: BYTE**

Указатель на буфер, получающий строку идентификации. Вызываемый объект выделяет этот буфер с помощью CoTaskMemAlloc. По завершении вызывающий объект должен освободить буфер, вызвав CoTaskMemFree.

[out] pdwIDStringLen

Тип: DWORD*

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

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

Тип: HRESULT

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

Возвращает E_INVALIDARG, если hwnd, idObject или 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