IAccessibleHandler ::AccessibleObjectFromID, méthode (oleacc.h)

Article
02/29/2024

La méthode AccessibleObjectFromID récupère un pointeur d’interface IAccessible pour l’interface associée à l’ID d’objet donné. Oleacc.dll utilise cette méthode pour obtenir un pointeur d’interface IAccessible pour les proxys fournis par un autre code.

RemarqueIAccessibleHandler ::AccessibleObjectFromID est déconseillé et ne doit pas être utilisé.

Syntaxe

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

Paramètres

[in] hwnd

Type : long

Spécifie le handle d’une fenêtre pour laquelle un pointeur d’interface IAccessible doit être récupéré.

[in] lObjectID

Type : long

Spécifie l'ID d'objet. Cette valeur est l’une des constantes d’identificateur d’objet standard ou un ID d’objet personnalisé.

[out] pIAccessible

Type : LPACCESSIBLE*

Spécifie l’adresse d’une variable pointeur qui reçoit l’adresse de l’interface IAccessible de l’objet.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

En cas de non-réussite, retourne l’un des codes d’erreur COM suivants ou un autre code d’erreur COM standard.

Erreur	Description
E_INVALIDARG	Un argument n’est pas valide.
E_NOINTERFACE	L’interface demandée n’est pas prise en charge.

Notes

Oleacc appelle cette fonction pour obtenir un pointeur d’interface IAccessible pour les S HWNDqui ont le nom de classe pour lequel ce gestionnaire est inscrit.

Au démarrage, Oleacc recherche la clé de Registre HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers et énumère chaque sous-clé (Oleacc s’attend à ce que la sous-clé soit un GUID). Oleacc lit le nom de classe associé à partir de HKCR\CLSID{guid}\AccClassName, où {guid} était le GUID trouvé sous la clé HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers. Quand Oleacc trouve une fenêtre avec un nom de classe qui correspond au GUID, il cocrée l’objet à l’aide du GUID, récupère le pointeur d’interface IAccessibleHandler et appelle AccessibleObjectFromID sur celle-ci pour accéder au pointeur d’interface IAccessible .

Comme avec d’autres méthodes et fonctions IAccessible , les clients peuvent recevoir des erreurs pour les pointeurs d’interface IAccessible en raison d’une action utilisateur. Pour plus d’informations, consultez Réception d’erreurs pour les pointeurs d’interface IAccessible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h
Bibliothèque	Oleacc.lib
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95

Share via