IAccPropServices::SetPropValue-Methode (oleacc.h)

Artikel
02/29/2024

Verwenden Sie SetPropValue , um das barrierefreie Element zu identifizieren, das kommentiert werden soll, geben Sie die Eigenschaft an, die kommentiert werden soll, und geben Sie einen neuen Wert für diese Eigenschaft an.

Wenn Serverentwickler den HWND des barrierefreien Elements kennen, das sie kommentieren möchten, können sie eine der folgenden Methoden verwenden:

Syntax

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

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] idProp

Typ: MSAAPROPID

Gibt die Eigenschaft des barrierefreien Elements an, das mit Anmerkungen versehen werden soll.

[in] var

Typ: VARIANT

Gibt einen neuen Wert für die Eigenschaft an.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn idProp keine unterstützte Eigenschaft ist, wenn var kein unterstützter Typ für diese Eigenschaft ist oder wenn die Identitätszeichenfolge ungültig 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. Beachten Sie, dass einige Eigenschaften derzeit nur unterstützt werden, wenn ein Rückruf verwendet wird und nicht direkt mit dieser Methode angegeben werden kann.

Anforderungen

Anforderung	Wert
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