Méthode IAccPropServices ::D ecomposeHwndIdentityString (oleacc.h)

Article
02/29/2024

Utilisez cette méthode pour déterminer le HWND, l’ID d’objet et l’ID enfant de l’élément accessible identifié par la chaîne d’identité.

Syntaxe

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

Paramètres

[in] pIDString

Type : const BYTE*

Pointeur vers une mémoire tampon contenant la chaîne d’identité d’un élément accessible basé sur HWND.

[in] dwIDStringLen

Type : DWORD

Spécifie la longueur de la chaîne d’identité spécifiée par pIDString.

[out] phwnd

Type : HWND*

Pointeur vers une mémoire tampon qui reçoit le HWND de l’élément accessible.

[out] pidObject

Type : DWORD*

Pointeur vers une mémoire tampon qui reçoit l'ID d'objet de l'élément accessible.

[out] pidChild

Type : DWORD*

Pointeur vers une mémoire tampon qui reçoit l'ID enfant de l'élément accessible.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

Retourne E_INVALIDARG si phwnd, pidObject ou pidChild ne sont pas valides, ou si la chaîne d’identité donnée n’est pas une chaîne d’identité basée sur HWND.

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

Remarques

Cette méthode réussit uniquement si la chaîne d’identité fournie est une chaîne d’identité basée sur HWND. Cette méthode est utile lorsqu’elle est utilisée dans un serveur de rappel IAccPropServer inscrit avec ANNO_CONTAINER’étendue, car elle permet au serveur de déterminer, à partir de la chaîne d’identité donnée, l’élément enfant (idChild) pour lequel le client appelle le serveur.

Configuration requise

Condition requise	Valeur
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