共用方式為

IAccPropServer：：GetPropValue 方法 (oleacc.h)

  • 發行項

擷取可存取項目的屬性值。

語法

HRESULT GetPropValue(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [in]  MSAAPROPID idProp,
  [out] VARIANT    *pvarValue,
  [out] BOOL       *pfHasProp
);

參數

[in] pIDString

類型： const BYTE*

包含可識別所要求屬性的字串。

[in] dwIDStringLen

類型： DWORD

指定 pIDString 參數所指定識別字串的長度。

[in] idProp

類型： MSAAPROPID

指定表示所需屬性的 GUID。

[out] pvarValue

類型： VARIANT*

指定所覆寫屬性的值。 只有當 pfHasProp 為 TRUE 時，此參數才有效。 如果 pfHasProp 設定為 FALSE，伺服器必須將此設定為 VT_EMPTY。

[out] pfHasProp

類型： BOOL*

表示伺服器是否提供所要求屬性的值。 如果伺服器傳回覆寫屬性或 FALSE 未傳回屬性 (，則伺服器應該將此設定為 TRUE，在此情況下，它也應該將 pvarValue 設定為 VT_EMPTY) 。

傳回值

類型： HRESULT

傳回S_OK，但記憶體不足等例外錯誤狀況除外。 如果未覆寫指定的屬性， 則 pfHasProp 應該設定為 FALSE ，而 pvarValue 應該設定為伺服器VT_EMPTY。

備註

如果註冊單一回呼對象來標註多個可存取元素，則識別字串可用來判斷此要求所參考的元素。

如果可存取的專案是以 HWND 為基礎， IAccPropServices：:D ecomposeHwndIdentityString 可用來從識別字元串擷取 HWND/idObject/idChild。

如果回呼有要針對指定屬性傳回的值，它應該會在 pvarValue 中傳回它，並將 pfHasProp 設定為 TRUE。 否則，它應該將 pvarValue 設定為 VT_EMPTY，並將 pfHasProp 設定為 FALSE。 在此後者的情況下，原始 的 IAccessible 介面指標將用來取得這個屬性的值。

規格需求

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