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。

如果 hmenuidChild 無效,則傳回E_INVALIDARG。

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

規格需求

需求
最低支援的用戶端 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