Partager via


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
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.
E_NOINTERFACE
L’objet spécifié dans le paramètre pAcc ne prend pas en charge l’interface spécifiée dans le paramètre riid .
E_OUTOFMEMORY
Mémoire insuffisante pour stocker la référence d’objet.
E_UNEXPECTED
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

Création d’objets proxy

Fonctionnement de WM_GETOBJECT

Comment gérer les WM_GETOBJECT

WM_GETOBJECT