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。

如果 hwnd、 idObject 或 idChild 無效，則傳回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