IAccPropServices：：SetPropValue 方法 (oleacc.h)

使用 SetPropValue 來識別要標註的可存取專案、指定要標註的屬性，併為該屬性提供新的值。

如果伺服器開發人員知道想要標註之可存取專案的 HWND ，則可以使用下列其中一種方法：

• IAccPropServices：：SetHwndPropStr，
• IAccPropServices：：SetHwndProp 或
• IAccPropServices：：SetHwndPropServer

語法

HRESULT SetPropValue(
  [in] const BYTE *pIDString,
  [in] DWORD      dwIDStringLen,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

參數

[in] pIDString

類型： const BYTE*

識別要標註的可存取項目。

[in] dwIDStringLen

類型： DWORD

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

[in] idProp

類型： MSAAPROPID

指定要標註之可存取項目的屬性。

[in] var

類型： VARIANT

指定屬性的新值。

傳回值

類型： HRESULT

如果成功，則傳回 S_OK。

如果 idProp 不是支持的屬性，如果 var 不是該屬性的支援類型，或識別字串無效，則傳回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