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

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

Синтаксис

HRESULT DecomposeHmenuIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HMENU      *phmenu,
  [out] DWORD      *pidChild
);

Параметры

[in] pIDString

Тип: const BYTE*

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

[in] dwIDStringLen

Тип: DWORD

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

[out] phmenu

Тип: HMENU*

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

[out] pidChild

Тип: DWORD*

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

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

Тип: HRESULT

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

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

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

Комментарии

Этот метод завершается успешно, только если указанная строка удостоверения является строкой удостоверения на основе HMENU. Этот метод полезен на сервере обратного вызова 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