IAccPropServices：：ClearProps 方法 (oleacc.h)

伺服器會使用 ClearProps ，將預設值還原為先前已標註之可存取元素的屬性。

如果伺服器知道想要清除之物件的 HWND ，則可以使用 IAccPropServices：：ClearHwndProps。

語法

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

參數

[in] pIDString

類型： const BYTE*

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

[in] dwIDStringLen

類型： DWORD

pIDString 的長度。

[in] paProps

類型： const MSAAPROPID*

指定要重設之屬性的陣列。 這些屬性會還原為標註之前所顯示的預設行為。

[in] cProps

類型： int

paProps 陣列的大小。

傳回值

類型： HRESULT

如果成功，則會傳回S_OK，即使未在可存取對象上標註指定的屬性也一樣;清除已清除的屬性會被視為成功。

如果不支援 paProps 陣列中的任何屬性，則傳回E_INVALIDARG。

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

備註

如需支持的屬性及其預期類型的清單，請參閱支援一節。

清除屬性的註釋會導致釋放任何相關聯的資源。 如果使用回呼屬性伺服器 (請參閱 SetPropServer) ，則會釋放它。

規格需求

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