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

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.

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.

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