IAccPropServices ::D ecomposeHmenuIdentityString, méthode (oleacc.h)

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

Syntaxe

HRESULT DecomposeHmenuIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HMENU      *phmenu,
  [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 HMENU.

[in] dwIDStringLen

Type : DWORD

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

[out] phmenu

Type : HMENU*

Pointeur vers une mémoire tampon qui reçoit le HMENU 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 phmenu 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 HMENU.

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 HMENU. Cette méthode est utile 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