IAccPropServices：:D ecomposeHwndIdentityString 方法 (oleacc.h)

使用這個方法來判斷識別字串所識別之可存取專案的 HWND、對象識別碼和子標識碼。

語法

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

參數

[in] pIDString

類型： const BYTE*

緩衝區的指標，其中包含 HWND 型可存取項目的識別字串。

[in] dwIDStringLen

類型： DWORD

指定由 pIDString 指定之識別字串的長度。

[out] phwnd

類型： HWND*

接收可存取專案 HWND 之緩衝區的指標。

[out] pidObject

類型： DWORD*

緩衝區的指標，接收可存取項目的物件識別碼。

[out] pidChild

類型： DWORD*

緩衝區的指標，接收可存取項目的子項識別碼。

傳回值

類型： HRESULT

如果成功，則傳回 S_OK。

如果 phwnd、 pidObject 或 pidChild 無效，或指定的識別字串不是 HWND 型識別字串，則傳回E_INVALIDARG。

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

備註

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

規格需求

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