共用方式為


IAccIdentity::GetIdentityString 方法 (oleacc.h)

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

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

語法

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