Méthode IAccPropServices ::SetPropValue (oleacc.h)

Utilisez SetPropValue pour identifier l’élément accessible à annoter, spécifier la propriété à annoter et fournir une nouvelle valeur pour cette propriété.

Si les développeurs de serveurs connaissent le HWND de l’élément accessible qu’ils veulent annoter, ils peuvent utiliser l’une des méthodes suivantes :

• IAccPropServices ::SetHwndPropStr,
• IAccPropServices ::SetHwndProp, ou
• IAccPropServices ::SetHwndPropServer

Syntaxe

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

Paramètres

[in] pIDString

Type : const BYTE*

Identifie l'élément accessible qui doit être annoté.

[in] dwIDStringLen

Type : DWORD

Spécifie la longueur de la chaîne identifiée par le paramètre pIDString.

[in] idProp

Type : MSAAPROPID

Spécifie la propriété de l'élément accessible à annoter.

[in] var

Type : VARIANT

Spécifie une nouvelle valeur pour la propriété.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

Renvoie E_INVALIDARG si idProp n’est pas une propriété prise en charge, si var n’est pas un type pris en charge pour cette propriété ou si la chaîne d’identité n’est pas valide.

Peut retourner d’autres codes d’erreur dans des conditions d’erreur exceptionnelles telles que la mémoire insuffisante.

Remarques

Consultez la section prise en charge pour obtenir la liste des propriétés prises en charge et leurs types attendus. Notez que certaines propriétés sont actuellement prises en charge uniquement lorsqu’un rappel est utilisé et ne peuvent pas être spécifiés directement à l’aide de cette méthode.

Configuration requise