IAccPropServices::SetPropServer-Methode (oleacc.h)

Artikel
08/25/2023

Server verwenden SetPropServer , um ein Rückrufobjekt anzugeben, das zum Kommentieren eines Arrays von Eigenschaften für das barrierefreie Element verwendet werden soll. Sie können auch angeben, ob die Anmerkung auf dieses barrierefreie Element oder auf das Element und seine untergeordneten Elemente angewendet werden soll. Diese Methode wird für Serveranmerkungen verwendet.

Wenn Serverentwickler den HWND des barrierefreien Elements kennen, das sie kommentieren möchten, können sie IAccPropServices::SetHwndPropServer verwenden.

Syntax

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

Parameter

[in] pIDString

Typ: const BYTE*

Gibt das barrierefreie Element an, das mit Anmerkungen versehen werden soll.

[in] dwIDStringLen

Typ: DWORD

Gibt die Länge der vom Parameter pIDString angegebenen Zeichenfolge an

[in] paProps

Typ: const MSAAPROPID*

Gibt ein Array von Eigenschaften an, das vom angegebenen Rückrufobjekt verarbeitet werden soll.

[in] cProps

Typ: int

Gibt ein Array von Eigenschaften an, das vom angegebenen Rückrufobjekt verarbeitet werden soll.

[in] pServer

Typ: IAccPropServer*

Gibt das Rückrufobjekt an, das aufgerufen wird, wenn ein Client eine der überschriebenen Eigenschaften anfordert.

[in] annoScope

Typ: AnnoScope

Kann ANNO_THIS sein, wodurch angegeben wird, dass sich die Anmerkung nur auf das angegebene barrierefreie Element auswirkt, oder ANNO_CONTAINER, wodurch angegeben wird, dass sie sich auf das Element und dessen direkte untergeordnete Elemente bezieht.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn eine der Eigenschaften im paProps-Array nicht unterstützt wird, wenn die Identitätszeichenfolge ungültig ist oder ob annoScope keine ANNO_THIS oder ANNO_CONTAINER ist.

Kann andere Fehlercodes unter außergewöhnlichen Fehlerbedingungen zurückgeben, z. B. unter geringem Arbeitsspeicher.

Hinweise

Im Abschnitt "Support" finden Sie eine Liste der unterstützten Eigenschaften und deren erwarteten Typen.

Die Laufzeit der Anmerkung verwendet AddRef , um den Verweiszähler für das pServer-Rückrufobjekt entsprechend zu erhöhen. Der Aufrufer kann ihn nach dem Aufrufen dieser Methode freigeben . Die Laufzeit der Anmerkung gibt das Rückrufobjekt automatisch frei, nachdem das barrierefreie Element, das kommentiert wird, nicht mehr verwendet wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h (OleAcc.h Include Initguid.h zuerst einschließen.)
DLL	Oleacc.dll
Verteilbare Komponente	Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98

Freigeben über