IAccPropServices：：SetPropServer 方法 (oleacc.h)

伺服器會使用 SetPropServer 來指定要用來標注可存取專案之屬性陣列的回呼物件。 您也可以指定批註是要套用至這個可存取的元素，還是套用至元素及其子系。 這個方法用於 伺服器批註。

如果伺服器開發人員知道他們想要批註之可存取專案的 HWND ，他們可以使用 IAccPropServices：：SetHwndPropServer。

語法

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

參數

[in] pIDString

類型：const BYTE*

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

[in] dwIDStringLen

類型： DWORD

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

[in] paProps

類型： const MSAAPROPID*

指定屬性陣列，該陣列會由指定的回呼物件所處理。

[in] cProps

類型： int

指定屬性陣列，該陣列會由指定的回呼物件所處理。

[in] pServer

類型： IAccPropServer*

指定用戶端要求其中一個被覆寫的屬性時叫用的回呼物件。

[in] annoScope

類型： AnnoScope

可以是 ANNO_THIS，表示附註只會影響指定的可存取項目，或者為 ANNO_CONTAINER，表示附註會套用到項目與其直接子項目。

傳回值

類型： HRESULT

如果成功，則傳回 S_OK。

如果 paProps 陣列中的任何屬性都不支援屬性、識別字串無效，或是 annoScope 不是其中一個ANNO_THIS或ANNO_CONTAINER，則傳回E_INVALIDARG。

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

備註

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

批註執行時間會使用 AddRef 來適當地遞增 pServer 回呼物件的參考計數器。 呼叫端在呼叫這個方法之後，可以 釋出 它。 批註執行時間會在已不再使用可存取的元素之後自動釋放回呼物件。

需求

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