Fonction LresultFromObject (oleacc.h)
Retourne une référence, similaire à un handle, à l’objet spécifié. Les serveurs retournent cette référence lors de la gestion des WM_GETOBJECT.
Syntaxe
LRESULT LresultFromObject(
[in] REFIID riid,
[in] WPARAM wParam,
[in] LPUNKNOWN punk
);
Paramètres
[in] riid
Type : REFIID
Identificateur de référence de l’interface fournie au client. Ce paramètre est IID_IAccessible.
[in] wParam
Type : WPARAM
Valeur envoyée par le message WM_GETOBJECT associé dans son paramètre wParam .
[in] punk
Type : LPUNKNOWN
Adresse de l’interface IAccessible à l’objet qui correspond au message WM_GETOBJECT .
Valeur retournée
Type : LRESULT
En cas de réussite, retourne une valeur positive qui est une référence à l’objet.
En cas de non-réussite, retourne l’une des valeurs de la table qui suit ou un autre code d’erreur COM standard.
| Code de retour | Description |
|---|---|
|
Un ou plusieurs arguments ne sont pas valides. |
|
L’objet spécifié dans le paramètre pAcc ne prend pas en charge l’interface spécifiée dans le paramètre riid . |
|
Mémoire insuffisante pour stocker la référence d’objet. |
|
Une erreur inattendue s’est produite. |
Remarques
Les serveurs appellent cette fonction uniquement lors de la gestion du message WM_GETOBJECT . Pour obtenir une vue d’ensemble de la façon dont LresultFromObject est lié à WM_GETOBJECT, consultez Fonctionnement WM_GETOBJECT.
LresultFromObject incrémente le nombre de références de l’objet. Si vous ne stockez pas le pointeur d’interface passé à la fonction (autrement dit, vous créez un pointeur d’interface pour l’objet chaque fois que WM_GETOBJECT est reçu), appelez la méthode Release de l’objet pour décrémenter le nombre de références. Ensuite, le client appelle Release et l’objet est détruit. Pour plus d’informations, consultez Comment gérer WM_GETOBJECT.
Chaque fois qu’un serveur traite WM_GETOBJECT pour un objet spécifique, il appelle LresultFromObject pour obtenir une nouvelle référence à l’objet. Les serveurs n’enregistrent pas la référence retournée par LresultFromObject à partir d’un instance de traitement WM_GETOBJECT à utiliser comme valeur de retour du message lors du traitement des messages WM_GETOBJECT suivants pour le même objet. Cela entraîne la réception d’une erreur par le client.
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 |
Voir aussi
Fonctionnement de WM_GETOBJECT