IAccIdentity：：GetIdentityString 方法 (oleacc.h)

擷取位元組字串， (可唯一識別可存取專案的識別字串) 。

如果伺服器開發人員知道想要標注之物件的 HWND ，則可以使用下列其中一種方法，而不是使用此方法並取得識別字串。

• IAccPropServices：：SetHwndPropStr
• IAccPropServices：：SetHwndProp
• IAccPropServices：：SetHwndPropServer

語法

HRESULT GetIdentityString(
  [in]  DWORD dwIDChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

參數

[in] dwIDChild

類型： DWORD

指定呼叫端想要識別的 IAccessible 物件子系。

[out] ppIDString

類型： BYTE**

變數位址，用來接收被呼叫端配置之識別字串的指標。 被呼叫者會使用 CoTaskMemAlloc配置識別字串;呼叫端必須在完成時使用 CoTaskMemFree 釋放識別字串。

[out] pdwIDStringLen

類型： DWORD*

變數位址，用來接收被呼叫端配置之識別字串的長度 (以位元組為單位)。

傳回值

類型： HRESULT

傳回S_OK，但例外狀況下除外，例如記憶體不足。 如果不支援，在 IAccIdentity上呼叫QueryInterface應該會失敗。

備註

傳回的字串應該視為不透明;用戶端應該只將其作為整體使用，而且不應該嘗試剖析它，或以手動方式解譯它。

如果用戶端知道或預期字串是以 HWND 為基礎，可以使用 IAccPropServices：:D ecomposeHwndIdentityString 嘗試分解識別字串。

需求

最低支援的用戶端	Windows Vista 或 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