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

Вызывающие элементы используют ComposeHmenuIdentityString для получения строки удостоверения для элемента, доступного на основе HMENU.

Синтаксис

HRESULT ComposeHmenuIdentityString(
  [in]  HMENU hmenu,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Параметры

[in] hmenu

Тип: HMENU

Определяет доступный элемент на основе HMENU.

[in] idChild

Тип: DWORD

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

[out] ppIDString

Тип: BYTE**

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

[out] pdwIDStringLen

Тип: DWORD*

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

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

Тип: HRESULT

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

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