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

Article
08/25/2023

Les serveurs utilisent SetPropServer pour spécifier un objet de rappel à utiliser pour annoter un tableau de propriétés pour l’élément accessible. Vous pouvez également spécifier si l’annotation doit être appliquée à cet élément accessible ou à l’élément et à ses enfants. Cette méthode est utilisée pour l’annotation de serveur.

Si les développeurs de serveurs connaissent le HWND de l’élément accessible qu’ils souhaitent annoter, ils peuvent utiliser IAccPropServices::SetHwndPropServer.

Syntaxe

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

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

Type : const MSAAPROPID*

Spécifie un tableau de propriétés qui doit être géré par l'objet de rappel spécifié.

[in] cProps

Type : int

Spécifie un tableau de propriétés qui doit être géré par l'objet de rappel spécifié.

[in] pServer

Type : IAccPropServer*

Spécifie l'objet de rappel, qui est appelé lorsqu'un client appelle l'une des propriétés substituées.

[in] annoScope

Type : AnnoScope

Peut être ANNO_THIS, indiquant que l'annotation affecte uniquement l'élément accessible indiqué, ou ANNO_CONTAINER, indiquant qu'elle s'applique à l'élément et à ses éléments enfants immédiats.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

Retourne E_INVALIDARG si l’une des propriétés du tableau paProps n’est pas prise en charge, si la chaîne d’identité n’est pas valide ou si annoScope n’est pas l’une des propriétés ANNO_THIS ou ANNO_CONTAINER.

Peut retourner d’autres codes d’erreur dans des conditions d’erreur exceptionnelles, telles qu’une mémoire insuffisante.

Notes

Consultez la section prise en charge pour obtenir la liste des propriétés prises en charge et leurs types attendus.

L’exécution de l’annotation utilise AddRef pour incrémenter le compteur de référence de l’objet de rappel pServer de manière appropriée. L’appelant est libre de le libérer après l’appel de cette méthode. L’exécution de l’annotation libère automatiquement l’objet de rappel une fois que l’élément accessible en cours d’annotation n’est plus utilisé.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h (incluez d’abord OleAcc.h Inclure Initguid.h))
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 2.0 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 98

Partager via