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。

如果 phmenu 或 pidChild 無效，或指定的識別字串不是 HMENU 型識別字串，則傳回E_INVALIDARG。

可能會在例外狀況下傳回其他錯誤碼，例如記憶體不足。

備註

只有在提供的識別字串是 HMENU 型識別字串時，這個方法才會成功。 這個方法在向 ANNO_CONTAINER 範圍註冊的 IAccPropServer 回呼伺服器很有用，因為它可讓伺服器從指定的識別字串中判斷 idChild 子元素， (idChild) 用戶端呼叫伺服器。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 oleacc.h (include OleAcc.h Include Initguid.h first.)
Dll Oleacc.dll
可轉散發套件 Windows NT 4.0 上的 Active Accessibility 2.0 RDK 與 SP6 和更新版本和 Windows 98